selectSingleNode Method

9/8/2008

Aplica o padrão especificado-compatível operação para contexto e retorna o primeiro compatível do este nó nó.

Sintaxe de script

var objXMLDOMNode = oXMLDOMNode.selectSingleNode(queryString);

Comentários

Parâmetros de script

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

Valor Return script

Objeto. Retorna o primeiro nó que corresponde a consulta XSL ou XPath. Se nenhum nó coincidir com a consulta, ele retorna nulo.

C/sintaxe C++

HRESULT selectSingleNode(
  BSTR queryString,
  IXMLDOMNode** resultNode
);

Comentários

C/parâmetros C++

• queryString
  [no] Seqüência de caracteres especificando a consulta XSL ou XPath que deve ser aplicado ao contexto definido por esse nó. O valor da SelectionLanguage propriedade interna (sinalizador) determina se uma consulta XSL 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.

• resultNode
  [out, retval] Primeiro nó que está selecionado, a consulta XPath. Se nenhum nós resultantes da consulta, ele retorna nulo.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

• S_FALSE
  Valor retornado se houver correspondência.

• E_INVALIDARG
  Valor retornado se resultNode é 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 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 Method, mas retorna somente o primeiro compatível nó em vez da lista de compatível todos os nós.

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:

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

See Also

Concepts

selectNodes Method