UITechnologyManager.Search 메서드

아티클
08/10/2011

부모 요소 내에서 제공된 쿼리 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 메서드를 사용하여 이전에 구문 분석된 쿼리 쿠키입니다.

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 메서드를 사용하여 쿼리가 일치하는지 확인합니다.

NotSupportedException

이 구현에서는 이 메서드를 지원하지 않습니다.

이 예외를 처리할 때 테스트 프레임워크는 GetChildren 메서드를 사용하여 계층을 통과하고 각 요소에서 MatchElement 메서드를 사용하여 쿼리가 일치하는지 확인합니다.

설명

구현자 참고 사항

이 메서드를 구현하는 것은 선택 사항입니다. 기본 기술에 UI 계층을 검색하고 탐색하기 위한 풍부한 API가 있는 경우 이 메서드를 구현하면 재생 성능이 크게 개선될 수 있습니다. 그러나, 이 메서드 또는 MatchElement(UITechnologyElement, Object, Boolean%) 메서드를 구현해야 합니다.