共用方式為


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[]

參數

  • maxDepth
    型別:System.Int32
    int ,表示要對控制項階層搜尋的深度。

傳回值

型別:array<System.Object[]
符合查詢的項目陣列,如果找不到任何項目則為 nullnull 參考 (即 Visual Basic 中的 Nothing)。

實作

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

例外狀況

例外狀況 條件
NotSupportedException

此實作不支援此方法。

為處理這個例外狀況,測試架構會使用 GetChildren 方法來周遊階層架構,並在每個項目上使用 MatchElement 方法以判斷是否符合查詢。

備註

實作者注意事項

實作這個方法是選擇性的。 如果基礎技術具備可搜尋及瀏覽 UI 階層架構的豐富 API,實作這個方法即可大幅提升播放效能。 但是,您必須實作這個方法或 MatchElement 方法。

.NET Framework 安全性

請參閱

參考

UITechnologyManager 類別

Microsoft.VisualStudio.TestTools.UITest.Extension 命名空間

GetChildren

MatchElement

ParseQueryId

UITechnologyElement