UITechnologyManager.Search-Methode

Sucht nach einem Element innerhalb des übergeordneten Elements, das der Bedingung des bereitgestellten Cookies der Abfrage-ID entspricht.

Namespace:  Microsoft.VisualStudio.TestTools.UITest.Extension
Assembly:  Microsoft.VisualStudio.TestTools.UITest.Extension (in Microsoft.VisualStudio.TestTools.UITest.Extension.dll)

Syntax

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

Parameter

• parsedQueryIdCookie
  Typ: System.Object
  Ein Abfragecookie, das zuvor mit der ParseQueryId-Methode analysiert wurde.

• parentElement
  Typ: Microsoft.VisualStudio.TestTools.UITest.Extension.IUITechnologyElement
  Ein IUITechnologyElement-Objekt.

• maxDepth
  Typ: System.Int32
  Ein int, der die Suchtiefe für die Steuerelementhierarchie angibt.

Rückgabewert

Typ: array<System.Object[]
Ein Array von Elementen, die der Abfrage entsprechen, oder nullNULL-Verweis (Nothing in Visual Basic), wenn keine Elemente gefunden wurden.

Implementiert

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

Ausnahmen

Ausnahme	Bedingung
NotSupportedException	Diese Implementierung unterstützt diese Methode nicht. Bei der Verarbeitung dieser Ausnahme verwendet das Testframework die Hierarchie mithilfe der GetChildren-Methode, und verwendet die MatchElement-Methode für jedes Element, um zu ermitteln, ob es mit der Abfrage übereinstimmt.

Hinweise

Hinweise zur Implementierung

Das Implementieren dieser Methode ist optional. Wenn die zugrunde liegende Technologie umfangreiche APIs zum Suchen und Navigieren der Benutzeroberflächen-Hierarchie hat, könnte diese Methode die Wiedergabeleistung erheblich verbessern. Sie müssen jedoch entweder diese Methode oder die MatchElement(UITechnologyElement, Object, Boolean%)-Methode implementieren.

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

UITechnologyManager Klasse

Microsoft.VisualStudio.TestTools.UITest.Extension-Namespace

GetChildren(UITechnologyElement, Object)

MatchElement(UITechnologyElement, Object, Boolean%)

ParseQueryId

UITechnologyElement