XmlReader.ReadElementContentAsString Método

Definição

Lê o elemento atual e retorna o conteúdo como um objeto String.Reads the current element and returns the contents as a String object.

Sobrecargas

ReadElementContentAsString(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto String.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

ReadElementContentAsString()

Lê o elemento atual e retorna o conteúdo como um objeto String.Reads the current element and returns the contents as a String object.

ReadElementContentAsString(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto String.Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);
public virtual string ReadElementContentAsString (string localName, string namespaceURI);
abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string
Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Parâmetros

localName
String

O nome local do elemento.The local name of the element.

namespaceURI
String

O URI do namespace do elemento.The namespace URI of the element.

Retornos

String

O elemento de conteúdo como um objeto String.The element content as a String object.

Exceções

O XmlReader não está posicionado em um elemento.The XmlReader is not positioned on an element.

- ou --or-

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."

O elemento atual contém elementos filho.The current element contains child elements.

- ou --or- O conteúdo do elemento não pode ser convertido em um objeto String.The element content cannot be converted to a String object.

O método é chamado com os argumentos null.The method is called with null arguments.

O nome do local especificado e o URI de namespace não correspondem àqueles do elemento atual que está sendo lido.The specified local name and namespace URI do not match that of the current element being read.

Exemplos

O exemplo a seguir lê o stringValue elemento e retorna o conteúdo do texto (ignorando o comentário e a instrução de processamento).The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

O exemplo usa o arquivo dataFile.xml como entrada.The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Comentários

Esse método lê a marca de início, o conteúdo do elemento e move o leitor após a marca do elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Ele expande as entidades e ignora as instruções e os comentários de processamento.It expands entities and ignores processing instructions and comments. O elemento só pode conter conteúdo simples.The element can only contain simple content. Ou seja, ele não pode ter elementos filho.That is, it cannot have child elements.

Para obter mais informações, consulte a seção comentários da XmlReader página de referência e o esquema XML do W3C parte 2: recomendação dos tipos de dados.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Aplica-se a

ReadElementContentAsString()

Lê o elemento atual e retorna o conteúdo como um objeto String.Reads the current element and returns the contents as a String object.

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

Retornos

String

O elemento de conteúdo como um objeto String.The element content as a String object.

Exceções

O XmlReader não está posicionado em um elemento.The XmlReader is not positioned on an element.

- ou --or-

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."

O elemento atual contém elementos filho.The current element contains child elements.

- ou --or- O conteúdo do elemento não pode ser convertido em um objeto String.The element content cannot be converted to a String object.

O método é chamado com os argumentos null.The method is called with null arguments.

Exemplos

O exemplo a seguir lê o stringValue elemento e retorna o conteúdo do texto (ignorando o comentário e a instrução de processamento).The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

O exemplo usa o arquivo dataFile.xml como entrada.The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Comentários

Esse método lê a marca de início, o conteúdo do elemento e move o leitor após a marca do elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Ele expande as entidades e ignora as instruções e os comentários de processamento.It expands entities and ignores processing instructions and comments. O elemento só pode conter conteúdo simples.The element can only contain simple content. Ou seja, ele não pode ter elementos filho.That is, it cannot have child elements.

Para obter mais informações, consulte a seção comentários da XmlReader página de referência e o esquema XML do W3C parte 2: recomendação dos tipos de dados.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

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

Aplica-se a