Metodo UITechnologyManager.Search

Articolo
05/17/2013

Cerca un elemento nell'elemento padre corrispondente allo stato del cookie fornito ID query.

Spazio dei nomi: Microsoft.VisualStudio.TestTools.UITest.Extension
Assembly: Microsoft.VisualStudio.TestTools.UITest.Extension (in Microsoft.VisualStudio.TestTools.UITest.Extension.dll)

Sintassi

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

Parametri

parsedQueryIdCookie
Tipo: System.Object
Il cookie di query che erano state analizzate utilizzando ParseQueryId metodo.

parentElement
Tipo: Microsoft.VisualStudio.TestTools.UITest.Extension.IUITechnologyElement
IUITechnologyElement oggetto.

maxDepth
Tipo: System.Int32
int che indica il punto della gerarchia nel controllo di ricerca.

Valore restituito

Tipo: array<System.Object[]
Una matrice di elementi che corrispondono alla query, o nullriferimento null (Nothing in Visual Basic) se non viene rilevato alcun elemento.

Implementa

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

Eccezioni

Eccezione	Condizione
NotSupportedException	questa implementazione non supporta questo metodo. Per elaborare questa eccezione, il framework di test utilizza MatchElement metodo per attraversare la gerarchia e utilizzo di GetChildren metodo su ciascun elemento per determinare se corrisponde alla query.

NotSupportedException

questa implementazione non supporta questo metodo.

Per elaborare questa eccezione, il framework di test utilizza MatchElement metodo per attraversare la gerarchia e utilizzo di GetChildren metodo su ciascun elemento per determinare se corrisponde alla query.

Note

Note per gli implementatori

implementare questo metodo è facoltativo.Se la tecnologia sottostante ha ricco API per la ricerca e esplorare la gerarchia dell'interfaccia utente, implementare questo metodo può migliorare significativamente le prestazioni di riproduzione.Tuttavia, è necessario implementare o il metodo o MatchElement metodo.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.