次の方法で共有

UITechnologyManager.Search メソッド

  • [アーティクル]

指定されたクエリ ID クッキーの条件に一致する親要素内の要素を検索します。

名前空間:  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 メソッドを使用して既に解析されているクエリ クッキー。
  • 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