XmlReader.ReadElementContentAsString Método

Definição

Namespace:

System.Xml

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Lê o elemento atual e retorna o conteúdo como um String objeto.

Sobrecargas

Nome	Description
ReadElementContentAsString(String, String)	Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um String objeto.
ReadElementContentAsString()	Lê o elemento atual e retorna o conteúdo como um String objeto.

ReadElementContentAsString(String, String)

Origem:

XmlReader.cs

Verifica se o nome local especificado e o URI do namespace correspondem ao do elemento atual, lê o elemento atual e retorna o conteúdo como um String objeto.

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.

namespaceURI

String

O URI do namespace do elemento.

Retornos

String

O conteúdo do elemento como um String objeto.

Exceções

InvalidOperationException

O XmlReader não está posicionado em um elemento.

- ou -

Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

XmlException

O elemento atual contém elementos filho.

- ou -

O conteúdo do elemento não pode ser convertido em um String objeto.

ArgumentNullException

O método é chamado com null argumentos.

ArgumentException

O nome local especificado e o URI do namespace não correspondem ao do elemento atual que está sendo lido.

Exemplos

O exemplo a seguir lê o stringValue elemento e retorna o conteúdo do texto (ignorando a instrução de comentário e processamento).

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 dataFile.xml arquivo como entrada.

<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 inicial, o conteúdo do elemento e move o leitor para além da marca do elemento final. Ele expande entidades e ignora instruções de processamento e comentários. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filho.

Para obter mais informações, consulte a seção Comentários da página de XmlReader referência e a recomendação W3C XML Schema Part 2: Datatypes .

ReadElementContentAsString()

Origem:

XmlReader.cs

Lê o elemento atual e retorna o conteúdo como um String objeto.

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 conteúdo do elemento como um String objeto.

Exceções

InvalidOperationException

O XmlReader não está posicionado em um elemento.

- ou -

Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

XmlException

O elemento atual contém elementos filho.

- ou -

O conteúdo do elemento não pode ser convertido em um String objeto.

ArgumentNullException

O método é chamado com null argumentos.

Exemplos

O exemplo a seguir lê o stringValue elemento e retorna o conteúdo do texto (ignorando a instrução de comentário e processamento).

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 dataFile.xml arquivo como entrada.

<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 inicial, o conteúdo do elemento e move o leitor para além da marca do elemento final. Ele expande entidades e ignora instruções de processamento e comentários. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filho.

Para obter mais informações, consulte a seção Comentários da página de XmlReader referência e a recomendação W3C XML Schema Part 2: Datatypes .

Para obter a versão assíncrona deste método, consulte ReadElementContentAsStringAsync.