AutomationElement.NameProperty 欄位

定義

識別 Name 屬性。Identifies the Name property.

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

欄位值

AutomationProperty

範例

下列範例會抓取屬性的目前值。The following example retrieves the current value of the property. 如果元素未提供預設值,則會傳回預設值。The default value is returned if the element does not provide one.

string nameProp =
    autoElement.GetCurrentPropertyValue(AutomationElement.NameProperty) as string;
Dim nameProp As String = _
    CStr(autoElement.GetCurrentPropertyValue(AutomationElement.NameProperty))

下列範例會抓取屬性目前的值,但指定如果專案本身未提供屬性的值, NotSupported 則會傳回而不是預設值。The following example retrieves the current value of the property, but specifies that if the element itself does not provide a value for the property, NotSupported is to be returned instead of a default value.

string nameProp1;
object namePropNoDefault =
    autoElement.GetCurrentPropertyValue(AutomationElement.NameProperty, true);
if (namePropNoDefault == AutomationElement.NotSupported)
{
    nameProp1 = "No name.";
}
else
{
    nameProp1 = namePropNoDefault as string;
}
Dim nameProp1 As String
Dim namePropNoDefault As Object = autoElement.GetCurrentPropertyValue(AutomationElement.NameProperty, True)
If namePropNoDefault Is AutomationElement.NotSupported Then
    nameProp1 = "No name."
Else
    nameProp1 = CStr(namePropNoDefault)
End If

備註

消費者介面自動化用戶端應用程式會使用此識別碼。This identifier is used by UI Automation client applications. 消費者介面自動化提供者應該在中使用對等的識別碼 AutomationElementIdentifiersUI Automation providers should use the equivalent identifier in AutomationElementIdentifiers.

這個屬性也可以從 Current 或屬性中抓取 CachedThis property can also be retrieved from the Current or Cached properties.

屬性的傳回值屬於類型 StringReturn values of the property are of type String. 屬性的預設值為空字串。The default value for the property is an empty string.

適用於