XmlReader.ReadElementString Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Lee los elementos sencillos de solo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString en su lugar, porque proporciona una manera más sencilla de controlar esta operación.

Sobrecargas

ReadElementString()	Lee un elemento de solo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString() en su lugar, porque proporciona una manera más sencilla de controlar esta operación.
ReadElementString(String)	Comprueba si la propiedad Name del elemento encontrado coincide con la cadena especificada antes de leer un elemento de sólo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString() en su lugar, porque proporciona una manera más sencilla de controlar esta operación.
ReadElementString(String, String)	Comprueba si las propiedades LocalName y NamespaceURI del elemento encontrado coinciden con las cadenas especificadas antes de leer un elemento de sólo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString(String, String) en su lugar, porque proporciona una manera más sencilla de controlar esta operación.

Comentarios

Se recomienda usar el ReadElementContentAsString método para leer un elemento de texto.

ReadElementString()

Lee un elemento de solo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString() en su lugar, porque proporciona una manera más sencilla de controlar esta operación.

public:
 virtual System::String ^ ReadElementString();

public virtual string ReadElementString ();

abstract member ReadElementString : unit -> string
override this.ReadElementString : unit -> string

Public Overridable Function ReadElementString () As String

Devoluciones

String

Texto que contiene el elemento leído. Una cadena vacía si el elemento está vacío.

Excepciones

XmlException

El siguiente nodo de contenido no es una etiqueta de apertura o el elemento encontrado no contiene un valor de texto simple.

InvalidOperationException

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

Comentarios

Se recomienda usar el ReadElementContentAsString() método para leer un elemento de texto.

ReadElementString(String)

Comprueba si la propiedad Name del elemento encontrado coincide con la cadena especificada antes de leer un elemento de sólo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString() en su lugar, porque proporciona una manera más sencilla de controlar esta operación.

public:
 virtual System::String ^ ReadElementString(System::String ^ name);

public virtual string ReadElementString (string name);

abstract member ReadElementString : string -> string
override this.ReadElementString : string -> string

Public Overridable Function ReadElementString (name As String) As String

Parámetros

name

String

Nombre que se va a comprobar.

Devoluciones

String

Texto que contiene el elemento leído. Una cadena vacía si el elemento está vacío.

Excepciones

XmlException

Si el siguiente nodo de contenido no es una etiqueta de apertura; si el elemento Name no coincide con el argumento especificado o si el elemento encontrado no contiene un valor de texto simple.

InvalidOperationException

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

Comentarios

Se recomienda usar el ReadElementContentAsString() método para leer un elemento de texto.

ReadElementString(String, String)

Comprueba si las propiedades LocalName y NamespaceURI del elemento encontrado coinciden con las cadenas especificadas antes de leer un elemento de sólo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString(String, String) en su lugar, porque proporciona una manera más sencilla de controlar esta operación.

public:
 virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);

public virtual string ReadElementString (string localname, string ns);

abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> string

Public Overridable Function ReadElementString (localname As String, ns As String) As String

Parámetros

localname

String

Nombre local que se va a comprobar.

ns

String

Identificador URI de espacio de nombres que se va a comprobar.

Devoluciones

String

Texto que contiene el elemento leído. Una cadena vacía si el elemento está vacío.

Excepciones

XmlException

Si el siguiente nodo de contenido no es una etiqueta de apertura; si el elemento LocalName o NamespaceURI no coincide con los argumentos especificados o si el elemento encontrado no contiene un valor de texto simple.

InvalidOperationException

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

Comentarios

Se recomienda usar el ReadElementContentAsString(String, String) método para leer un elemento de texto.