XmlReader.ReadInnerXml Método

Definição

Quando substituído em uma classe derivada, lê todo o conteúdo, incluindo a marcação, como uma cadeia de caracteres.When overridden in a derived class, reads all the content, including markup, as a string.

public:
 virtual System::String ^ ReadInnerXml();
public virtual string ReadInnerXml ();
abstract member ReadInnerXml : unit -> string
override this.ReadInnerXml : unit -> string
Public Overridable Function ReadInnerXml () As String

Retornos

String

Todo o conteúdo XML, incluindo a marcação, no nó atual.All the XML content, including markup, in the current node. Se o nó atual não tiver nenhum filho, uma cadeia de caracteres vazia será retornada.If the current node has no children, an empty string is returned.

Se o nó atual não for um elemento nem um atributo, uma cadeia de caracteres vazia será retornada.If the current node is neither an element nor attribute, an empty string is returned.

Exceções

O XML está malformado ou ocorreu um erro ao analisar o XML.The XML was not well-formed, or an error occurred while parsing the XML.

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Exemplos

O exemplo a seguir compara ReadInnerXml os ReadOuterXml métodos e.The following example compares the ReadInnerXml and ReadOuterXml methods.

// Load the file and ignore all white space.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreWhitespace = true;
using (XmlReader reader = XmlReader.Create("2books.xml")) {

  // Moves the reader to the root element.
  reader.MoveToContent();

  // Moves to book node.
  reader.Read();

  // Note that ReadInnerXml only returns the markup of the node's children
  // so the book's attributes are not returned.
  Console.WriteLine("Read the first book using ReadInnerXml...");
  Console.WriteLine(reader.ReadInnerXml());

  // ReadOuterXml returns the markup for the current node and its children
  // so the book's attributes are also returned.
  Console.WriteLine("Read the second book using ReadOuterXml...");
  Console.WriteLine(reader.ReadOuterXml());
}
' Load the file and ignore all white space.
Dim settings As New XmlReaderSettings()
settings.IgnoreWhitespace = True
Using reader As XmlReader = XmlReader.Create("2books.xml")

  ' Moves the reader to the root element.
  reader.MoveToContent()
                
  ' Moves to book node.
  reader.Read()
                
  ' Note that ReadInnerXml only returns the markup of the node's children
  ' so the book's attributes are not returned.
  Console.WriteLine("Read the first book using ReadInnerXml...")
  Console.WriteLine(reader.ReadInnerXml())
                
  ' ReadOuterXml returns the markup for the current node and its children
  ' so the book's attributes are also returned.
  Console.WriteLine("Read the second book using ReadOuterXml...")
  Console.WriteLine(reader.ReadOuterXml())

End Using

O exemplo usa 2books.xml arquivo como entrada.The example uses 2books.xml file as input.

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

Comentários

Esse método retorna todo o conteúdo do nó atual, incluindo a marcação.This method returns all the content of the current node including the markup. O nó atual (marca de início) e o nó de fim correspondente (marca de fim) não são retornados.The current node (start tag) and corresponding end node (end tag) are not returned. Por exemplo, se você tiver o seguinte:For example, if you had the following:

<node>  
 this <child id="123"/>  
</node>  

ReadInnerXml retorna this <child id="123"/>ReadInnerXml returns this <child id="123"/>

Esse método trata os nós de elemento e atributo da seguinte maneira:This method handles element and attribute nodes in the following manner:

Tipo de nóNode type Posição antes da chamadaPosition before the call Fragmento XMLXML fragment Valor retornadoReturn value Posição após a chamadaPosition after the call
Element Na tag de início de item1.On the item1 start tag. <item1>Texto2 de Texto1 </item1> <item2></item2><item1>text1</item1><item2>text2</item2> text1text1 Na tag de início de item2.On the item2 start tag.
Attribute No nó de atributo attr1.On the attr1 attribute node. <item attr1="val1" attr2="val2">text</item><item attr1="val1" attr2="val2">text</item> val1val1 Permanece no nó de atributo attr1.Remains on the attr1 attribute node.

Se o leitor estiver posicionado em um nó folha, chamar ReadInnerXml será o mesmo que chamar Read.If the reader is positioned on a leaf node, calling ReadInnerXml is equivalent to calling Read. O método retorna String.Empty (exceto para nós de atributo; nesse caso, o valor do atributo é retornado).The method returns String.Empty (except for attribute nodes, in which case the value of the attribute is returned).

Esse método verifica se há XML bem formado.This method checks for well-formed XML. Se ReadInnerXml for chamado a partir de um XmlValidatingReader , esse método também validará o conteúdo retornado.If ReadInnerXml is called from an XmlValidatingReader, this method also validates the content returned.

Conforme implementado nas XmlNodeReader XmlTextReader classes e, XmlValidatingReader o ReadOuterXml método é ciente do namespace.As implemented in the XmlNodeReader, XmlTextReader and XmlValidatingReader classes the ReadOuterXml method is namespace aware.

Para obter a versão assíncrona desse método, consulte ReadInnerXmlAsync .For the asynchronous version of this method, see ReadInnerXmlAsync.

Aplica-se a