AutomationElement.AutomationIdProperty Campo

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 

Valore del campo

Esempio

Nell'esempio seguente viene recuperato il valore corrente della proprietà . Il valore predefinito viene restituito se l'elemento non ne fornisce uno.

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

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

Nell'esempio seguente viene recuperato il valore corrente della proprietà , ma viene specificato che se l'elemento stesso non fornisce un valore per la proprietà , NotSupported deve essere restituito anziché un valore predefinito.

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

Commenti

Questo identificatore viene usato dalle applicazioni client Automazione interfaccia utente. Automazione interfaccia utente provider devono usare l'identificatore equivalente in AutomationElementIdentifiers.

Questa proprietà può essere recuperata anche dalle Current proprietà o Cached .

I valori restituiti della proprietà sono di tipo String. Il valore predefinito per la proprietà è una stringa vuota.

Quando è disponibile, è previsto che l'oggetto AutomationIdProperty di un elemento sia sempre lo stesso in qualsiasi istanza dell'applicazione indipendentemente dalla lingua locale. Il valore deve essere univoco tra gli elementi di pari livello, ma non necessariamente univoco nell'intero desktop. Ad esempio, più istanze di un'applicazione o più visualizzazioni di cartelle in Microsoft Windows Explorer possono contenere elementi con lo stesso AutomationIdProperty, ad esempio "SystemMenuBar".

Anche se il supporto di è AutomationId sempre consigliato per migliorare la verificabilità, questa proprietà non è obbligatoria. Se supportato, è AutomationId utile per creare script di automazione dei test eseguiti indipendentemente dal linguaggio dell'interfaccia utente. I client non devono fare ipotesi relative agli AutomationIdoggetti esposti da altre applicazioni. Non AutomationId è necessariamente garantito che sia stabile in versioni diverse o compilazioni di un'applicazione.

Le istanze degli elementi dell'interfaccia utente sono identificate in modo univoco sul desktop dalle relative RuntimeIdProperty proprietà.

Vedi anche

• RuntimeIdProperty
• panoramica delle proprietà di automazione dell'interfaccia utente
• Obtaining Automazione interfaccia utente Elements