Compartilhar via


Método UITechnologyManager.Search

Procura por um elemento no elemento pai que coincida com a condição do cookie de identificação de consulta fornecido.

Namespace:  Microsoft.VisualStudio.TestTools.UITest.Extension
Assembly:  Microsoft.VisualStudio.TestTools.UITest.Extension (em Microsoft.VisualStudio.TestTools.UITest.Extension.dll)

Sintaxe

'Declaração
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
    Um cookie de consulta que foi anteriormente analisado usando o ParseQueryId método.
  • maxDepth
    Tipo: System.Int32
    Um int que indica a profundidade na hierarquia de controle para pesquisa.

Valor de retorno

Tipo: array<System.Object[]
Uma matriz de elementos que correspondem à consulta, ou nulluma referência nula (Nothing no Visual Basic) se nenhum elemento for encontrado.

Implementações

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

Exceções

Exceção Condição
NotSupportedException

Esta implementação não oferece suporte a esse método.

Para processar essa exceção, a estrutura de teste usa o GetChildren método para atravessar a hierarquia e usa o MatchElement método em cada elemento para determinar se coincide com a consulta.

Comentários

Observações para implementadores

Implementar este método é opcional. Se a tecnologia subjacente tiver APIs avançadas para pesquisar e navegar na hierarquia de interface do usuário, esse método de implementação pode melhorar significativamente o desempenho de reprodução. No entanto, você deve implementar ambos este método ou a MatchElement(UITechnologyElement, Object, Boolean%) método.

Segurança do .NET Framework

Consulte também

Referência

UITechnologyManager Classe

Namespace Microsoft.VisualStudio.TestTools.UITest.Extension

GetChildren(UITechnologyElement, Object)

MatchElement(UITechnologyElement, Object, Boolean%)

ParseQueryId

UITechnologyElement