AutomationElementMode 列舉
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
包含值，這些值會指定傳回使用者介面自動化項目時所使用的參考型別。 這些值用於 AutomationElementMode 屬性。
public enum class AutomationElementModeC#
public enum AutomationElementModetype AutomationElementMode = Public Enum AutomationElementMode- 繼承
| 名稱 | 值 | Description |
|---|---|---|
| Full | 1 | 指定傳回的專案具有基礎 UI 的完整參考。 |
| None | 0 | 指定傳回的專案沒有基礎 UI 的參考，而且只包含快取的資訊。 本模式可能的用途，例如：不必取得項目本身的參考，即可擷取清單方塊內項目的名稱。 |
下列範例示範如何在 上 CacheRequest 設定模式。
C#
// Set up the request.
CacheRequest cacheRequest = new CacheRequest();
// Do not get a full reference to the cached objects, only to their cached properties and patterns.
cacheRequest.AutomationElementMode = AutomationElementMode.None;
' Set up the request.
Dim cacheRequest As New CacheRequest()
' Do not get a full reference to the cached objects, only to their cached properties and patterns.
cacheRequest.AutomationElementMode = AutomationElementMode.None
Full 是預設值，並指定傳回的專案包含基礎使用者介面的完整參考， (UI) 。 None 指定傳回的專案沒有基礎 UI 的參考，而且只包含快取的資訊。
或 SetFocus 等 GetCurrentPropertyValue 專案上的某些作業需要完整參考;嘗試在沒有任何結果 InvalidOperationException 的專案上執行這些作業。
當只需要屬性時，使用 None 會更有效率，因為它可避免設定完整參考時所需的額外負荷。
| 產品 | 版本 |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
