UITechnologyManager.Search (Método)

Artículo
05/15/2013

Busca un elemento en el elemento primario que coincida con la condición de la cookie del identificador de consulta proporcionado.

Espacio de nombres: Microsoft.VisualStudio.TestTools.UITest.Extension
Ensamblado: Microsoft.VisualStudio.TestTools.UITest.Extension (en Microsoft.VisualStudio.TestTools.UITest.Extension.dll)

Sintaxis

'Declaración
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[]

Parámetros

parsedQueryIdCookie
Tipo: System.Object
Cookie de consulta que se analizó previamente utilizando el método ParseQueryId.

parentElement
Tipo: Microsoft.VisualStudio.TestTools.UITest.Extension.IUITechnologyElement
Un objeto IUITechnologyElement.

maxDepth
Tipo: System.Int32
Valor de tipo int que indica qué nivel de profundidad va a usarse al buscar en la jerarquía de controles.

Valor devuelto

Tipo: array<System.Object[]
Una matriz de elementos que coinciden con la consulta o nullreferencia null (Nothing en Visual Basic) si no se encuentran elementos.

Implementaciones

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

Excepciones

Excepción	Condición
NotSupportedException	Esta implementación no admite este método. Para procesar esta excepción, el marco de la prueba usa el método GetChildren para atravesar la jerarquía y usa el método MatchElement en cada elemento para determinar si coincide con la consulta.

NotSupportedException

Esta implementación no admite este método.

Para procesar esta excepción, el marco de la prueba usa el método GetChildren para atravesar la jerarquía y usa el método MatchElement en cada elemento para determinar si coincide con la consulta.

Comentarios

Notas para los implementadores

La implementación de este método es opcional.Si la tecnología subyacente tiene API enriquecidas para buscar y navegar la jerarquía de la interfaz de usuario, al implementar este método se podría mejorar significativamente el rendimiento de la reproducción.Sin embargo, debe implementar este método o el método MatchElement.

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.