C# UIAutomation如何添加自定义模式/属性获取控件IsValid值

不需要实现复杂的自定义UIA模式、不需要注册全局自定义属性，直接使用UIA原生内置的ItemStatus标准属性即可，这是当前场景下实现成本最低、语义最匹配、测试端调用最便捷的方案。

你之前采用IToggleProvider挪用Toggle状态的方案属于典型的语义错位：Toggle模式是专门为复选框、开关这类可交互切换状态的控件设计的，用来表示输入校验状态完全不符合UIA规范，这也是你需要在测试代码里加大量注释解释状态含义的根本原因。

具体实现步骤 #

只需要修改自定义TextBox的AutomationPeer实现，删掉冗余的IToggleProvider相关代码，重写GetItemStatusCore方法返回校验状态即可：

internal class ValidatingTextBox : TextBox
{
    internal bool IsValid;

    internal ValidatingTextBox()
    {
    }
    protected override AutomationPeer OnCreateAutomationPeer()
    {
        return new ValidatingTextBoxAutomationPeer(this);
    }
}

internal class ValidatingTextBoxAutomationPeer : TextBoxAutomationPeer
{
    private readonly ValidatingTextBox _ownerTextBox;

    internal ValidatingTextBoxAutomationPeer(ValidatingTextBox textBox) : base(textBox)
    {
        _ownerTextBox = textBox;
    }

    protected override string GetItemStatusCore()
    {
        // ItemStatus是UIA规范专门预留的、用于暴露控件自定义业务状态的标准属性
        return _ownerTextBox.IsValid ? "InputValid" : "InputInvalid";
    }
}

测试端调用方式 #

测试代码不需要做特殊适配，直接读取UIA元素原生支持的ItemStatus属性即可判断，代码语义一目了然，完全不需要额外注释说明：

// 读取校验状态，语义清晰无歧义
bool isInputValid = textboxAutomationElement.Current.ItemStatus == "InputValid";

方案优势 #

• 实现成本极低：仅需重写一个十余行的核心方法，不需要处理COM注册、自定义模式的客户端/服务端双向适配等复杂逻辑，没有额外的维护成本
• 符合UIA规范：ItemStatus本身就是UIA标准定义的属性，屏幕阅读器、各类自动化测试框架都原生支持读取，不存在兼容性问题
• 可读性强：不管是控件端代码还是测试端代码，状态含义直接体现在属性语义里，不需要靠注释解释非标准的状态映射
• 兼容性好：全版本WPF（从.NET Framework 3.0到最新版.NET）、UIA2/UIA3客户端都能正常读取该属性，不需要做版本适配

常见误区说明 #

• 不需要手动查找IRawElementProviderSimple实例：WPF的AutomationPeer框架会自动完成Peer到UIA COM接口的包装，你只需要在Peer层重写对应的属性返回方法，UIA客户端就能直接读到值，不需要手动实现或查找该接口。
• 自定义UIA属性、自定义模式属于重武器：只有当你需要暴露多个自定义属性、需要支持自定义交互操作的时候才需要用，单传一个校验状态完全没必要引入这么高的复杂度。

内容的提问来源于stack exchange，提问作者Betty Crokker