XmlReader.ReadElementContentAsString Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Lee el elemento actual y devuelve el contenido como un String objeto .

Sobrecargas

Nombre	Description
ReadElementContentAsString(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un String objeto .
ReadElementContentAsString()	Lee el elemento actual y devuelve el contenido como un String objeto .

ReadElementContentAsString(String, String)

Source:

XmlReader.cs

Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un 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

Nombre local del elemento.

namespaceURI

String

Identificador URI del espacio de nombres del elemento.

Devoluciones

String

Contenido del elemento como un String objeto .

Excepciones

InvalidOperationException

No XmlReader se coloca en un elemento .

O bien

Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

XmlException

El elemento actual contiene elementos secundarios.

O bien

El contenido del elemento no se puede convertir en un String objeto .

ArgumentNullException

Se llama al método con null argumentos.

ArgumentException

El nombre local especificado y el URI del espacio de nombres no coinciden con el del elemento actual que se está leyendo.

Ejemplos

En el ejemplo siguiente se lee el stringValue elemento y se devuelve el contenido del texto (se omite la instrucción de comentario y procesamiento).

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

En el ejemplo se usa el dataFile.xml archivo 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>

Comentarios

Este método lee la etiqueta de inicio, el contenido del elemento y mueve el lector más allá de la etiqueta de elemento final. Expande las entidades y omite las instrucciones de procesamiento y los comentarios. El elemento solo puede contener contenido simple. Es decir, no puede tener elementos secundarios.

Para obtener más información, vea la sección Comentarios de la XmlReader página de referencia y la recomendación esquema XML de W3C, parte 2: Tipos de datos .

ReadElementContentAsString()

Source:

XmlReader.cs

Lee el elemento actual y devuelve el contenido como un 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

Devoluciones

String

Contenido del elemento como un String objeto .

Excepciones

InvalidOperationException

No XmlReader se coloca en un elemento .

O bien

Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

XmlException

El elemento actual contiene elementos secundarios.

O bien

El contenido del elemento no se puede convertir en un String objeto .

ArgumentNullException

Se llama al método con null argumentos.

Ejemplos

En el ejemplo siguiente se lee el stringValue elemento y se devuelve el contenido del texto (se omite la instrucción de comentario y procesamiento).

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

En el ejemplo se usa el dataFile.xml archivo 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>

Comentarios

Este método lee la etiqueta de inicio, el contenido del elemento y mueve el lector más allá de la etiqueta de elemento final. Expande las entidades y omite las instrucciones de procesamiento y los comentarios. El elemento solo puede contener contenido simple. Es decir, no puede tener elementos secundarios.

Para obtener más información, vea la sección Comentarios de la XmlReader página de referencia y la recomendación esquema XML de W3C, parte 2: Tipos de datos .

Para obtener la versión asincrónica de este método, vea ReadElementContentAsStringAsync.