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>