Partager via

UITechnologyManager.Search, méthode

  • Article

Recherche un élément dans l'élément parent qui correspond à la condition du cookie d'ID de requête fourni.

Espace de noms :  Microsoft.VisualStudio.TestTools.UITest.Extension
Assembly :  Microsoft.VisualStudio.TestTools.UITest.Extension (dans Microsoft.VisualStudio.TestTools.UITest.Extension.dll)

Syntaxe

'Déclaration
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[]

Paramètres

  • parsedQueryIdCookie
    Type : System.Object
    Cookie de requête analysé précédemment à l'aide de la méthode ParseQueryId.
  • maxDepth
    Type : System.Int32
    int qui indique jusqu'à quel niveau rechercher dans la hiérarchie des contrôles.

Valeur de retour

Type : array<System.Object[]
Tableau des éléments qui correspondent à la requête ou nullune référence null (Nothing en Visual Basic) si aucun élément n'est trouvé.

Implémentations

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

Exceptions

Exception Condition
NotSupportedException

Cette implémentation ne prend pas en charge cette méthode.

Pour le traitement de cette exception, l'infrastructure de test utilise la méthode GetChildren pour parcourir la hiérarchie et utilise la méthode MatchElement sur chaque élément pour déterminer s'il correspond à la requête.

Notes

Remarques à l'attention des implémenteurs

L'implémentation de cette méthode est facultative. Si la technologie sous-jacente a des API riches pour la recherche et la navigation dans la hiérarchie d'interface utilisateur, l'implémentation de cette méthode pourrait améliorer les performances de lecture de façon significative. Toutefois, vous devez implémenter cette méthode ou la méthode MatchElement(UITechnologyElement, Object, Boolean%).

Sécurité .NET Framework

Voir aussi

Référence

UITechnologyManager Classe

Microsoft.VisualStudio.TestTools.UITest.Extension, espace de noms

GetChildren(UITechnologyElement, Object)

MatchElement(UITechnologyElement, Object, Boolean%)

ParseQueryId

UITechnologyElement