selectNodes Method

9/8/2008

Aplica o padrão especificado-compatível operação ao contexto neste nó e retorna a lista de compatível nós como As IXMLDOMNodeList.

Sintaxe de script

var objXMLDOMNodeList = oXMLDOMNode.selectNodes(expression);

Comentários

Parâmetros de script

• expressão
  Seqüência de caracteres especificando a consulta XSLPattern ou XPath que deve ser aplicado ao contexto definido por esse nó. O valor da propriedade interna de SelectionLanguage (sinalizador) determina se uma consulta XSLPattern ou XPath é usada. Por padrão, a expressão é uma consulta XSLPattern. A propriedade interna SelectionLanguage (sinalizador) pode ser definida com o setProperty Method.

Valor Return script

Objeto. Retorna uma coleção de nós selecionado por uma consulta XSL Pattern ou XPath. Se nenhum nós forem selecionados, um vazio coleção é retornada.

C/sintaxe C++

HRESULT selectNodes(
  BSTR expression,
  IXMLDOMNodeList** resultList
);

Comentários

C/parâmetros C++

• expressão
  [no] O valor da SelectionLanguage propriedade interna (sinalizador) determina se uma consulta XSL Pattern ou XPath é usada. Por padrão, a expressão é uma consulta padrão XSL. O SelectionLanguage propriedade interna (sinalizador) pode ser definida com o SetProperty método.

• resultList
  [out, retval] Lista de nós selecionados pela consulta XSL Pattern ou XPath. Se nenhum nós são selecionados pela consulta, um vazio nó lista é retornada.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

• E_INVALIDARG
  Valor retornado se resultList é nulo.

Requisitos

Header	msxml2.h, msxml2.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

Comentários Gerais

Este método é válido somente se o recurso XML Query Language (XQL) foi incluído na sistema operacional (OS). Se um chamar para esse método é feita e XQL não é com suporte, uma mensagem de erro será retornada.

O selectSingleNode método é semelhante de SelectNodes método, mas retorna somente o primeiro compatível nó em vez da lista de compatível todos os nós.

As IXMLDOMNodeList é ao vivo e imediatamente reflete as alterações de nós que aparecem na lista.

Esse membro é uma extensão de Document Object Model (DOM) de W3C (World Wide Web Consortium) (W3C (World Wide Web Consortium)).

Este método se aplica ao seguinte objetos e interfaces:

As IXMLDOMNodeList, IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, e IXTLRuntime.

See Also

Concepts

setProperty Method
selectSingleNode Method