text Property

9/8/2008

Representa o de conteúdo de texto do nó ou o texto concatenado que representa o nó e seus descendentes.

Sintaxe de script

            strValue = oXMLDOMNode.text;

Comentários

Parâmetros de script

Nenhum.

Valor Return script

Seqüência de caracteres. Seqüência de caracteres que representa o de conteúdo de texto de neste nó e seus descendentes. Esse valor varia depending on o valor da NodeType propriedade.

C/sintaxe C++

HRESULT get_text(
  BSTR* text
);

Comentários

C/parâmetros C++

• Texto
  [out, retval] Seqüência de caracteres que representa o de conteúdo de texto de neste nó e seus descendentes. Esse valor varia depending on o valor da NodeType propriedade.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

• S_FALSE
  Valor retornado quando não houver nenhum texto.

• E_INVALIDARG
  Valor retornado se Texto é nulo.

Requisitos

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

Comentários Gerais

Quando concatenada, o texto representa o conteúdo do texto ou CDATA nós. Todos os nós de texto concatenados são normalizados de acordo com xml: space Atributos e o valor da preserveWhiteSpace alternar. Não é normalizado concatenado texto CDATA. (Nós filho que contêm nós NODE_COMMENT e NODE_PROCESSING_INSTRUCTION não forem concatenadas.)

Recupera e define a seqüência de caracteres que representa o conteúdo de texto deste nó ou o texto concatenado que representa este nó e seus descendentes.

Para controle mais preciso sobre a manipulação de texto em um documento XML, use inferior-nível nodeValue propriedade, que retorna o processado texto associado com um nó NODE_TEXT.

Considere o "raiz" elemento neste exemplo.

<root att="   123   a   <   ">
   <a>   a   a   </a>
   <!--   comment   b   -->
   <?pi   pi   c   ?>
   <![CDATA[   cdata   d   ]]>
   e   f
</root>

A propriedade de texto para o elemento raiz retornará a seguinte concatenada de texto.

"a a   cdata   d    e f"

Observe que a espaço em branco dentro de nó CDATA é preservado.

Esse valor depende de como o valor da NodeType propriedade.

Valor	Descrição
NODE_ATTRIBUTE, NODE_DOCUMENT, NODE_ENTITY	Retorna um seqüência de caracteres que representa o valor do nó. Este é o texto concatenado de todos os subnós com entidades expandidas.
NODE_CDATA_SECTION, NODE_COMMENT, NODE_PROCESSING_INSTRUCTION, NODE_TEXT	Retorna o texto contido no nó, que é igual a nodeValue propriedade.
NODE_DOCUMENT_TYPE, NODE_NOTATION	Retorna a seqüência vazia (" "). Esses tipos nó não tem associado texto.
NODE_DOCUMENT_FRAGMENT	Retorna o texto composto da concatenação de todos os nós descendentes.
NODE_ELEMENT	Contém um seqüência de caracteres que representa o elemento de conteúdo. Observe que isso também será incluem o de conteúdo de texto de todos os elementos filho, concatenados em ordem documento. Por exemplo, considere a possibilidade de seguinte XML: O Texto propriedade para a < contagem > elemento contém o valor " Uma dois três quatro ".
NODE_ENTITY_REFERENCE	Retorna o representação de seqüência de caracteres da referência de entidade.

Esta propriedade é leitura/gravação e 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

nodeType Property
nodeValue Property