AutomationElement.AutomationIdProperty 字段

  • 参考

定义

命名空间:
System.Windows.Automation
程序集:
UIAutomationClient.dll

标识 AutomationId 属性，该属性用于标识元素。

public: static initonly System::Windows::Automation::AutomationProperty ^ AutomationIdProperty;
public static readonly System.Windows.Automation.AutomationProperty AutomationIdProperty;
 staticval mutable AutomationIdProperty : System.Windows.Automation.AutomationProperty
Public Shared ReadOnly AutomationIdProperty As AutomationProperty

字段值

AutomationProperty

示例

以下示例检索 属性的当前值。 如果元素未提供默认值，则返回默认值。

string autoId =
    autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty) as string;

Dim autoId As String = _
    CStr(autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty))

以下示例检索属性的当前值，但指定如果元素本身未为属性提供值， NotSupported 则返回 而不是默认值。

string autoIdString;
object autoIdNoDefault =
    autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty, true);
if (autoIdNoDefault == AutomationElement.NotSupported)
{
    // TODO Handle the case where you do not wish to proceed using the default value.
}
else
{
    autoIdString = autoIdNoDefault as string;
}

Dim autoIdString As String
Dim autoIdNoDefault As Object = autoElement.GetCurrentPropertyValue(AutomationElement.AutomationIdProperty, True)
If autoIdNoDefault Is AutomationElement.NotSupported Then
    ' TODO Handle the case where you do not wish to proceed using the default value.
Else
    autoIdString = CStr(autoIdNoDefault)
End If

注解

此标识符由 UI 自动化客户端应用程序使用。 UI 自动化提供程序应使用 中的 AutomationElementIdentifiers等效标识符。

也可以从 Current 或 Cached 属性检索此属性。

属性的返回值的类型为 String。 属性的默认值为空字符串。

当它可用时，无论本地语言如何， AutomationIdProperty 在应用程序的任何实例中，元素的 应始终相同。 值在同级元素中应是唯一的，但不一定在整个桌面上是唯一的。 例如，一个应用程序的多个实例或 Microsoft Windows 资源管理器中的多个文件夹视图可能包含具有相同 AutomationIdProperty的元素，例如“SystemMenuBar”。

尽管始终建议支持 AutomationId 以提高可测试性，但此属性不是必需的。 在支持的情况下， AutomationId 可用于创建不考虑 UI 语言运行的测试自动化脚本。 客户端不应对其他应用程序公开的 AutomationId做出假设。 AutomationId不一定保证 在应用程序的不同版本或内部版本中保持稳定。

用户界面 (UI) 元素的实例通过其 RuntimeIdProperty 属性在桌面上唯一标识。

备注

控件视图中（除顶级应用程序窗口外）的所有 UI 自动化元素、派生自没有 ID 或 x:Uid 的 Windows Presentation Foundation (WPF) 控件的 UI 自动化元素以及派生自没有控件 ID 的 Win32 控件的 UI 自动化元素都支持 AutomationIdProperty。

适用于

另请参阅