다음을 통해 공유


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