XmlReader.ReadElementContentAsString XmlReader.ReadElementContentAsString XmlReader.ReadElementContentAsString XmlReader.ReadElementContentAsString Method

Definición

Lee el elemento actual y devuelve el contenido como un objeto String.Reads the current element and returns the contents as a String object.

Sobrecargas

ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String)

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

Lee el elemento actual y devuelve el contenido como un objeto String.Reads the current element and returns the contents as a String object.

ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String)

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

Nombre local del elemento.The local name of the element.

namespaceURI
String String String String

Identificador URI de espacio de nombres del elemento.The namespace URI of the element.

Devoluciones

Contenido de elemento como objeto String.The element content as a String object.

Excepciones

El XmlReader no está situado en ningún elemento.The XmlReader is not positioned on an element.

O bien-or-

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

El elemento actual contiene elementos secundarios.The current element contains child elements.

o bien-or- El contenido de elemento no puede convertirse en un objeto String.The element content cannot be converted to a String object.

Se llama al método con argumentos null.The method is called with null arguments.

El nombre local y el identificador URI del espacio de nombres especificados no coinciden con los del elemento que se está leyendo.The specified local name and namespace URI do not match that of the current element being read.

Ejemplos

En el ejemplo siguiente se stringValue lee el elemento y se devuelve el contenido de texto (omitiendo el comentario y la instrucción de procesamiento).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

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

Comentarios

Este método lee la etiqueta de apertura, el contenido del elemento y desplaza el lector más allá de la etiqueta del elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Expande las entidades y omite las instrucciones de procesamiento y los comentarios.It expands entities and ignores processing instructions and comments. El elemento solo puede contener contenido simple.The element can only contain simple content. Es decir, no puede tener elementos secundarios.That is, it cannot have child elements.

Para obtener más información, vea la sección Comentarios de XmlReader la página de referencia y el esquema XML de W3C parte 2: Recomendación de tipos de los tipos de.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

ReadElementContentAsString() ReadElementContentAsString() ReadElementContentAsString() ReadElementContentAsString()

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

Devoluciones

Contenido de elemento como objeto String.The element content as a String object.

Excepciones

El XmlReader no está situado en ningún elemento.The XmlReader is not positioned on an element.

o bien-or-

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

El elemento actual contiene elementos secundarios.The current element contains child elements.

O bien-or- El contenido de elemento no puede convertirse en un objeto String.The element content cannot be converted to a String object.

Se llama al método con argumentos null.The method is called with null arguments.

Ejemplos

En el ejemplo siguiente se stringValue lee el elemento y se devuelve el contenido de texto (omitiendo el comentario y la instrucción de procesamiento).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

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

Comentarios

Este método lee la etiqueta de apertura, el contenido del elemento y desplaza el lector más allá de la etiqueta del elemento final.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. Expande las entidades y omite las instrucciones de procesamiento y los comentarios.It expands entities and ignores processing instructions and comments. El elemento solo puede contener contenido simple.The element can only contain simple content. Es decir, no puede tener elementos secundarios.That is, it cannot have child elements.

Para obtener más información, vea la sección Comentarios de XmlReader la página de referencia y el esquema XML de W3C parte 2: Recomendación de tipos de los tipos de.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Para obtener la versión asincrónica de este método, vea ReadElementContentAsStringAsync.For the asynchronous version of this method, see ReadElementContentAsStringAsync.

Se aplica a