// 私有字段（實際存儲數據）
private string _name = "默認名稱";
// CLR屬性（對外暴露的訪問接口）
public string Name
{
    get => _name; // 讀訪問器：獲取字段值
    set => _name = value; // 寫訪問器：設置字段值，value是關鍵字，表示傳入的新值
}

private int _age;
public int Age
{
    get => _age;
    set
    {
        // 校驗邏輯：年齡不能為負數
        if (value >= 0) 
            _age = value;
        else
            throw new ArgumentException("年齡不能為負數");
    }
}
// 計算屬性：無對應的私有字段，值由其他屬性計算而來
public string AgeDesc
{
    get => _age >= 18 ? "成年人" : "未成年人";
}

using System.Windows;
using System.Windows.Controls;
// 自定義控件：繼承自Control（間接繼承DependencyObject）
public class MyCustomControl : Control
{
    // 1. 注冊依賴屬性：公共靜態(tài)只讀字段，命名規(guī)范【屬性名+Property】
    public static readonly DependencyProperty MyTextProperty =
        DependencyProperty.Register(
            nameof(MyText), // 依賴屬性對應的CLR屬性名（必須一致）
            typeof(string), // 屬性的類型
            typeof(MyCustomControl), // 所屬的控件類型
            new PropertyMetadata( // 屬性元數據：設置默認值、變化回調等
                "默認文本", // ① 屬性默認值
                OnMyTextChanged // ② 屬性值變化時的回調方法（可選）
            )
        );
    // 2. CLR屬性包裝：對外暴露常規(guī)訪問方式，內部調用GetValue/SetValue
    public string MyText
    {
        get => (string)GetValue(MyTextProperty); // 從WPF屬性系統(tǒng)取值
        set => SetValue(MyTextProperty, value); // 向WPF屬性系統(tǒng)賦值
    }
    // 3. 可選：屬性值變化的回調方法（處理邏輯，如通知UI、更新其他屬性）
    private static void OnMyTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        // d：當前控件實例；e：變化參數（OldValue舊值，NewValue新值）
        var control = (MyCustomControl)d;
        string oldText = (string)e.OldValue;
        string newText = (string)e.NewValue;
        // 這里可以添加屬性變化后的邏輯，比如更新控件樣式、觸發(fā)事件等
        control.ToolTip = $"文本從「{oldText}」改為「{newText}」";
    }
}

<!-- 引用自定義控件的命名空間（假設命名空間是WpfPropertyDemo） -->
<Window x:Class="WpfPropertyDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfPropertyDemo"
        Title="依賴屬性示例" Height="200" Width="300">
    <StackPanel Spacing="10" HorizontalAlignment="Center" VerticalAlignment="Center">
        <!-- 1. 靜態(tài)賦值：直接設置MyText -->
        <local:MyCustomControl MyText="我是自定義控件" Width="200" Height="50" Background="LightBlue"/>
        <!-- 2. 數據綁定：和ViewModel的屬性關聯(lián)（支持WPF所有綁定特性） -->
        <local:MyCustomControl MyText="{Binding ViewModelText}" Width="200" Height="50" Background="LightGreen"/>
    </StackPanel>
</Window>

<!-- 原生依賴屬性的核心用法：數據綁定 -->
<TextBox Text="{Binding UserName, Mode=TwoWay}"/>
<Button Content="確認" Command="{Binding ConfirmCommand}"/>
<TextBlock Foreground="{Binding TipColor}" Text="{Binding TipMessage}"/>

<!-- Grid.Row/Grid.Column是Grid的附加屬性，被Button/TextBox使用 -->
<Grid>
    <Grid.RowDefinitions>
        <RowDefinition/>
        <RowDefinition/>
    </Grid.RowDefinitions>
    <!-- Button使用Grid的Row附加屬性，指定在第0行 -->
    <Button Grid.Row="0" Content="第0行按鈕"/>
    <!-- TextBox使用Grid的Row附加屬性，指定在第1行 -->
    <TextBox Grid.Row="1" PlaceholderText="第1行輸入框"/>
</Grid>

using System.Windows;
using System.Windows.Controls;
// 附加屬性的定義類（可任意類，只要靜態(tài)方法+注冊Attached）
public static class MyAttachHelper
{
    // 1. 注冊附加屬性：使用RegisterAttached
    public static readonly DependencyProperty ShowBorderProperty =
        DependencyProperty.RegisterAttached(
            "ShowBorder", // 附加屬性名
            typeof(bool), // 屬性類型
            typeof(MyAttachHelper), // 所屬類
            new PropertyMetadata(false, OnShowBorderChanged) // 默認值false，變化回調
        );
    // 2. 公共靜態(tài)Get方法：供外部獲取屬性值（命名規(guī)范：Get+屬性名）
    public static bool GetShowBorder(DependencyObject obj)
    {
        return (bool)obj.GetValue(ShowBorderProperty);
    }
    // 3. 公共靜態(tài)Set方法：供外部設置屬性值（命名規(guī)范：Set+屬性名）
    public static void SetShowBorder(DependencyObject obj, bool value)
    {
        obj.SetValue(ShowBorderProperty, value);
    }
    // 4. 屬性值變化的回調：處理邏輯（給控件加/去邊框）
    private static void OnShowBorderChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        // d是使用該附加屬性的控件實例，判斷是否是FrameworkElement（所有可視化控件的基類）
        if (d is FrameworkElement element)
        {
            bool isShow = (bool)e.NewValue;
            // 根據值設置邊框：如果是Button/TextBox，直接設置BorderBrush和BorderThickness
            if (element is Button button)
            {
                button.BorderBrush = isShow ? Brushes.Black : Brushes.Transparent;
                button.BorderThickness = isShow ? new Thickness(1) : new Thickness(0);
            }
            else if (element is TextBox textBox)
            {
                textBox.BorderBrush = isShow ? Brushes.Red : Brushes.Gray;
                textBox.BorderThickness = isShow ? new Thickness(2) : new Thickness(1);
            }
        }
    }
}

<Window x:Class="WpfPropertyDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfPropertyDemo"
        Title="附加屬性示例" Height="200" Width="300">
    <StackPanel Spacing="10" HorizontalAlignment="Center" VerticalAlignment="Center">
        <!-- Button使用自定義附加屬性：顯示黑色邊框 -->
        <Button local:MyAttachHelper.ShowBorder="True" Content="帶邊框按鈕" Width="100"/>
        <!-- TextBox使用自定義附加屬性：顯示紅色粗邊框 -->
        <TextBox local:MyAttachHelper.ShowBorder="True" PlaceholderText="帶邊框輸入框" Width="200"/>
        <!-- 普通TextBlock：不設置，默認無邊框 -->
        <TextBlock Text="無邊框文本" Width="200"/>
    </StackPanel>
</Window>