AutomationElement.AutomationIdProperty Bidang

Definisi

Ruang nama:

System.Windows.Automation

Rakitan:

UIAutomationClient.dll

AutomationId Mengidentifikasi properti , yang digunakan untuk mengidentifikasi elemen.

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 

Nilai Bidang

AutomationProperty

Contoh

Contoh berikut mengambil nilai properti saat ini. Nilai default dikembalikan jika elemen tidak menyediakannya.

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

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

Contoh berikut mengambil nilai properti saat ini, tetapi menentukan bahwa jika elemen itu sendiri tidak memberikan nilai untuk properti , NotSupported akan dikembalikan alih-alih nilai default.

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

Keterangan

Pengidentifikasi ini digunakan oleh aplikasi klien Automation UI. Penyedia Automation UI harus menggunakan pengidentifikasi yang setara di AutomationElementIdentifiers.

Properti ini juga dapat diambil dari Current properti atau Cached .

Nilai yang dikembalikan dari properti berjenis String. Nilai default untuk properti adalah string kosong.

Ketika tersedia AutomationIdProperty , elemen diharapkan selalu sama dalam instans aplikasi apa pun terlepas dari bahasa lokalnya. Nilai harus unik di antara elemen saudara tetapi belum tentu unik di seluruh desktop. Misalnya, beberapa instans aplikasi, atau beberapa tampilan folder di Microsoft Windows Explorer, mungkin berisi elemen dengan yang sama AutomationIdProperty, seperti "SystemMenuBar".

Meskipun dukungan dari suatu selalu direkomendasikan untuk keterujian yang AutomationId lebih baik, properti ini tidak wajib. Jika didukung, AutomationId berguna untuk membuat skrip otomatisasi pengujian yang berjalan terlepas dari bahasa UI. Klien tidak boleh membuat asumsi mengenai s yang AutomationIddiekspos oleh aplikasi lain. AutomationId Belum tentu dijamin stabil di berbagai rilis atau build aplikasi.

Instans elemen antarmuka pengguna (UI) diidentifikasi secara unik di desktop oleh propertinya RuntimeIdProperty .

Catatan

AutomationIdProperty didukung oleh semua elemen Automasi Antarmuka Pengguna dalam tampilan kontrol kecuali jendela aplikasi tingkat atas, elemen Automasi Antarmuka Pengguna yang berasal dari kontrol Windows Presentation Foundation (WPF) yang tidak memiliki ID atau x:Uid, dan elemen Automasi Antarmuka Pengguna yang berasal dari kontrol Win32 yang tidak memiliki ID kontrol.

Lihat juga

• RuntimeIdProperty
• Ringkasan Properti UI Automation
• Mendapatkan Elemen Automasi Antarmuka Pengguna