UITechnologyManager.Search, méthode

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 : Object

  Cookie de requête analysé précédemment à l'aide de la méthode ParseQueryId.

• parentElement
  Type : Microsoft.VisualStudio.TestTools.UITest.Extension.IUITechnologyElement

  Objet IUITechnologyElement.

• maxDepth
  Type : Int32

  int qui indique jusqu'à quel niveau rechercher dans la hiérarchie des contrôles.

Valeur de retour

Type : array<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.

Sécurité .NET Framework

• Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

UITechnologyManager Classe

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

GetChildren

ParseQueryId

UITechnologyElement