AutomationElement.AutomationIdProperty Feld

Referenz

Definition

Namespace:: System.Windows.Automation

Assembly:: UIAutomationClient.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bezeichnet die AutomationId-Eigenschaft, die zum Identifizieren von Elementen verwendet wird.

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

AutomationProperty

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.

Hinweis

AutomationIdProperty wird von allen Benutzeroberflächenautomatisierungs-Elementen in der Steuerelementansicht unterstützt. Davon ausgenommen sind lediglich Anwendungsfenster der obersten Ebene, Benutzeroberflächenautomatisierungs-Elemente, die von WPF-Steuerelementen (Windows Presentation Foundation) ohne ID oder x:Uid abgeleitet wurden, und Benutzeroberflächenautomatisierungs-Elemente, die aus Win32-Steuerelementen abgeleitet wurden, die keine Steuerelement-ID haben.

Gilt für:

Freigeben über