Condividi tramite

Metodo UITechnologyManager.Search

  • Articolo

Cerca un elemento nell'elemento padre che soddisfa la condizione del cookie dell'ID di query fornito.

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

  • maxDepth
    Tipo: System.Int32
    Oggetto int che indica il livello di profondità della ricerca all'interno della gerarchia dei controlli.

Valore restituito

Tipo: array<System.Object[]
Matrice di elementi che corrispondono alla query oppure nullriferimento null (Nothing in Visual Basic) se non viene trovato alcun elemento corrispondente.

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 il metodo GetChildren per attraversare la gerarchia e utilizza il metodo MatchElement su ogni elemento per determinare se corrisponde alla query.

Note

Note per gli implementatori

L'implementazione di questo metodo è facoltativa. Se la tecnologia sottostante dispone di API dettagliate finalizzate alla ricerca e alla navigazione all'interno della gerarchia dell'interfaccia utente, l'implementazione di questo metodo potrebbe migliorare significativamente le prestazioni in fase di riproduzione. Tuttavia, è necessario implementare questo metodo o il metodo MatchElement(UITechnologyElement, Object, Boolean%).

Sicurezza di .NET Framework

Vedere anche

Riferimenti

UITechnologyManager Classe

Spazio dei nomi Microsoft.VisualStudio.TestTools.UITest.Extension

GetChildren(UITechnologyElement, Object)

MatchElement(UITechnologyElement, Object, Boolean%)

ParseQueryId

UITechnologyElement