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 keinen 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 aber 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ächenautomatisierungs-Clientanwendungen verwendet. Benutzeroberflächenautomatisierungsanbieter sollten den entsprechenden Bezeichner in AutomationElementIdentifiersverwenden.

Diese Eigenschaft kann auch aus den Current Eigenschaften oder Cached abgerufen 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 erwartet, dass die AutomationIdProperty eines Elements in jedem instance der Anwendung unabhängig von der lokalen Sprache immer gleich ist. Der Wert sollte für gleichgeordnete Elemente eindeutig sein, aber nicht unbedingt auf dem gesamten Desktop. Beispielsweise können mehrere Instanzen einer Anwendung oder mehrere Ordneransichten in Microsoft Windows Explorer Elemente mit demselben AutomationIdPropertyenthalten, z. B. "SystemMenuBar".

Obwohl die Unterstützung von immer AutomationId empfohlen wird, um die Testbarkeit zu verbessern, ist diese Eigenschaft nicht obligatorisch. Wenn es unterstützt wird, ist ein AutomationId nützlich, um Testautomatisierungsskripts zu erstellen, die unabhängig von der Benutzeroberflächensprache ausgeführt werden. Clients sollten keine Annahmen bezüglich der AutomationIdvon anderen Anwendungen verfügbar gemachten s treffen. Ein AutomationId ist nicht unbedingt sicher, dass es in verschiedenen Releases oder Builds einer Anwendung stabil ist.

Instanzen von Benutzeroberflächenelementen werden auf dem Desktop anhand ihrer RuntimeIdProperty Eigenschaften eindeutig identifiziert.

Gilt für:

Weitere Informationen

• RuntimeIdProperty
• Übersicht über die Benutzeroberflächenautomatisierungs-Eigenschaften
• Abrufen von Benutzeroberflächenautomatisierungs-Elementen