C# WPF 中的​属性示例详解

// 私有字段（实际存储数据）
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. 注册依赖属性：公共静态只读字段，命名规范【属性名+Property】
    public static readonly DependencyProperty MyTextProperty =
        DependencyProperty.Register(
            nameof(MyText), // 依赖属性对应的CLR属性名（必须一致）
            typeof(string), // 属性的类型
            typeof(MyCustomControl), // 所属的控件类型
            new PropertyMetadata( // 属性元数据：设置默认值、变化回调等
                "默认文本", // ① 属性默认值
                OnMyTextChanged // ② 属性值变化时的回调方法（可选）
            )
        );
    // 2. CLR属性包装：对外暴露常规访问方式，内部调用GetValue/SetValue
    public string MyText
    {
        get => (string)GetValue(MyTextProperty); // 从WPF属性系统取值
        set => SetValue(MyTextProperty, value); // 向WPF属性系统赋值
    }
    // 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;
        // 这里可以添加属性变化后的逻辑，比如更新控件样式、触发事件等
        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. 静态赋值：直接设置MyText -->
        <local:MyCustomControl MyText="我是自定义控件" Width="200" Height="50" Background="LightBlue"/>
        <!-- 2. 数据绑定：和ViewModel的属性关联（支持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;
// 附加属性的定义类（可任意类，只要静态方法+注册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. 公共静态Get方法：供外部获取属性值（命名规范：Get+属性名）
    public static bool GetShowBorder(DependencyObject obj)
    {
        return (bool)obj.GetValue(ShowBorderProperty);
    }
    // 3. 公共静态Set方法：供外部设置属性值（命名规范：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>