AutomationElement.AutomationIdProperty Feld

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 

Feldwert

Beispiele

Im folgenden Beispiel wird der aktuelle Wert der Eigenschaft abgerufen. Der Standardwert wird zurückgegeben, wenn das Element kein Element bereitstellt.

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

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

Das folgende Beispiel ruft den aktuellen Wert der Eigenschaft ab, gibt jedoch an, dass, wenn das Element selbst keinen Wert für die Eigenschaft bereitstellt, NotSupported anstelle eines Standardwerts zurückgegeben werden soll.

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

Hinweise

Dieser Bezeichner wird von Benutzeroberflächenautomatisierung Clientanwendungen verwendet. Benutzeroberflächenautomatisierung Anbieter sollten den entsprechenden Bezeichner in AutomationElementIdentifiers verwenden.

Diese Eigenschaft kann auch aus den Current Eigenschaften abgerufen Cached werden.

Rückgabewerte der Eigenschaft sind vom Typ String. Der Standardwert für die Eigenschaft ist eine leere Zeichenfolge.

Wenn es verfügbar ist, wird davon ausgegangen, dass das AutomationIdProperty Element in jeder Instanz der Anwendung unabhängig von der lokalen Sprache immer gleich ist. Der Wert sollte zwischen gleichgeordneten Elementen eindeutig sein, aber nicht unbedingt für den gesamten Desktop. Beispielsweise können mehrere Instanzen einer Anwendung oder mehrere Ordneransichten im Microsoft Windows Explorer Elemente mit demselben AutomationIdProperty enthalten, z. B. "SystemMenuBar".

Die Unterstützung einer AutomationId Eigenschaft wird zwar immer für eine bessere Testbarkeit empfohlen, diese Eigenschaft ist jedoch nicht obligatorisch. Wo sie unterstützt wird, ist eine AutomationId hilfreiche Möglichkeit zum Erstellen von Testautomatisierungsskripts, die unabhängig von der Benutzeroberflächensprache ausgeführt werden. Kunden sollten keine Annahmen hinsichtlich der AutomationIdvon anderen Anwendungen verfügbar gemachten Daten machen. Eine AutomationId ist nicht unbedingt garantiert, dass sie über verschiedene Versionen oder Builds einer Anwendung hinweg stabil ist.

Instanzen von Ui-Elementen (User Interface) werden auf dem Desktop durch ihre RuntimeIdProperty Eigenschaften eindeutig identifiziert.

Weitere Informationen

• RuntimeIdProperty
• Übersicht über Benutzeroberflächenautomatisierung-Eigenschaften
• Obtaining Benutzeroberflächenautomatisierung Elements