UITechnologyManager.Search 方法
搜尋父項目中與提供之查詢 ID Cookie 的條件相符的項目。
命名空間: Microsoft.VisualStudio.TestTools.UITest.Extension
組件: Microsoft.VisualStudio.TestTools.UITest.Extension (在 Microsoft.VisualStudio.TestTools.UITest.Extension.dll 中)
語法
'宣告
Public MustOverride Function Search ( _
parsedQueryIdCookie As Object, _
parentElement As IUITechnologyElement, _
maxDepth As Integer _
) As Object()
public abstract Object[] Search(
Object parsedQueryIdCookie,
IUITechnologyElement parentElement,
int maxDepth
)
public:
virtual array<Object^>^ Search(
Object^ parsedQueryIdCookie,
IUITechnologyElement^ parentElement,
int maxDepth
) abstract
abstract Search :
parsedQueryIdCookie:Object *
parentElement:IUITechnologyElement *
maxDepth:int -> Object[]
public abstract function Search(
parsedQueryIdCookie : Object,
parentElement : IUITechnologyElement,
maxDepth : int
) : Object[]
參數
- parsedQueryIdCookie
型別:System.Object
先前使用 ParseQueryId 方法剖析的查詢 Cookie。
- parentElement
型別:Microsoft.VisualStudio.TestTools.UITest.Extension.IUITechnologyElement
IUITechnologyElement 物件。
- maxDepth
型別:System.Int32
int ,表示要對控制項階層搜尋的深度。
傳回值
型別:array<System.Object[]
符合查詢的項目陣列,如果找不到任何項目則為 nullnull 參考 (即 Visual Basic 中的 Nothing)。
實作
IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)
例外狀況
例外狀況 | 條件 |
---|---|
NotSupportedException | 此實作不支援此方法。 為處理這個例外狀況,測試架構會使用 GetChildren 方法來周遊階層架構,並在每個項目上使用 MatchElement 方法以判斷是否符合查詢。 |
備註
實作者注意事項
實作這個方法是選擇性的。 如果基礎技術具備可搜尋及瀏覽 UI 階層架構的豐富 API,實作這個方法即可大幅提升播放效能。 但是,您必須實作這個方法或 MatchElement 方法。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。
請參閱
參考
Microsoft.VisualStudio.TestTools.UITest.Extension 命名空間
GetChildren
MatchElement