XmlReader.ReadElementContentAsString Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Lee el elemento actual y devuelve el contenido como un objeto String.
Sobrecargas
| 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. |
| ReadElementContentAsString() |
Lee el elemento actual y devuelve el contenido como un objeto String. |
ReadElementContentAsString(String, String)
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
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.
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 -> stringPublic Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As StringParámetros
- localName
- String
Nombre local del elemento.
- namespaceURI
- String
Identificador URI de espacio de nombres del elemento.
Devoluciones
Contenido de elemento como objeto String.
Excepciones
El XmlReader no está situado en ningún elemento.
o bien
Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.
El elemento actual contiene elementos secundarios.
o bien
El contenido de elemento no puede convertirse en un objeto String.
Se llama al método con argumentos null.
El nombre local y el identificador URI del espacio de nombres especificados no coinciden con los del elemento que se está leyendo.
Ejemplos
En el ejemplo siguiente se lee el stringValue elemento y se devuelve el contenido del texto (ignorando la instrucción de procesamiento y comentario).
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.
<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 .
Se aplica a
ReadElementContentAsString()
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
- Source:
- XmlReader.cs
Lee el elemento actual y devuelve el contenido como un objeto String.
public:
virtual System::String ^ ReadElementContentAsString();public virtual string ReadElementContentAsString ();abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> stringPublic Overridable Function ReadElementContentAsString () As StringDevoluciones
Contenido de elemento como objeto String.
Excepciones
El XmlReader no está situado en ningún elemento.
o bien
Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.
El elemento actual contiene elementos secundarios.
o bien
El contenido de elemento no puede convertirse en un objeto String.
Se llama al método con argumentos null.
Ejemplos
En el ejemplo siguiente se lee el stringValue elemento y se devuelve el contenido del texto (ignorando la instrucción de procesamiento y comentario).
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.
<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.
