AutomationElement.AutomationIdProperty Fält

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 

Fältvärde

Exempel

I följande exempel hämtas det aktuella värdet för egenskapen. Standardvärdet returneras om elementet inte tillhandahåller något.

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

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

I följande exempel hämtas det aktuella värdet för egenskapen, men anger att om själva elementet inte tillhandahåller något värde för egenskapen NotSupported , returneras i stället för ett standardvärde.

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

Kommentarer

Den här identifieraren används av UI Automation klientprogram. UI Automation providers bör använda motsvarande identifierare i AutomationElementIdentifiers.

Den här egenskapen kan också hämtas från Current egenskaperna eller Cached .

Returvärden för egenskapen är av typen String. Standardvärdet för egenskapen är en tom sträng.

När det är tillgängligt förväntas elementet AutomationIdProperty alltid vara detsamma i alla instanser av programmet oavsett det lokala språket. Värdet ska vara unikt bland syskonelement men inte nödvändigtvis unikt för hela skrivbordet. Till exempel kan flera instanser av ett program eller flera mappvyer i Microsoft Windows Explorer innehålla element med samma AutomationIdProperty, till exempel "SystemMenuBar".

Även om stöd för en AutomationId alltid rekommenderas för bättre testbarhet, är den här egenskapen inte obligatorisk. Där det stöds är ett AutomationId användbart alternativ för att skapa testautomatiseringsskript som körs oavsett användargränssnittsspråk. Klienter bör inte göra några antaganden om de AutomationIdsom exponeras av andra program. En AutomationId är inte nödvändigtvis garanterad att vara stabil i olika versioner eller versioner av ett program.

Instanser av användargränssnittselement identifieras unikt på skrivbordet av deras RuntimeIdProperty egenskaper.

Se även

• RuntimeIdProperty
• Översikt över egenskaper för användargränssnittsautomatisering
• Obtaining UI Automation Elements