Compartir vía


XmlReader.ReadContentAsBoolean Método

Definición

Lee el contenido de texto en la posición actual como valor Boolean.

public:
 virtual bool ReadContentAsBoolean();
public virtual bool ReadContentAsBoolean ();
abstract member ReadContentAsBoolean : unit -> bool
override this.ReadContentAsBoolean : unit -> bool
Public Overridable Function ReadContentAsBoolean () As Boolean

Devoluciones

Boolean

El contenido del texto como objeto Boolean.

Excepciones

La conversión intentada no es válida.

El formato de la cadena no es válido.

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

Ejemplos

En el ejemplo siguiente se usa el ReadContentAsBoolean método para leer el atributo como un Boolean valor.

using (XmlReader reader = XmlReader.Create("dataFile_2.xml")) {
      reader.ReadToDescendant("item");
      do {
          reader.MoveToAttribute("sale-item");
          Boolean onSale = reader.ReadContentAsBoolean();
          if (onSale) {
             Console.WriteLine(reader["productID"]);
          }
      } while (reader.ReadToNextSibling("item"));	
}
Using reader As XmlReader = XmlReader.Create("dataFile_2.xml")
              
  reader.ReadToDescendant("item")
              
  Do
    reader.MoveToAttribute("sale-item")
    Dim onSale As [Boolean] = reader.ReadContentAsBoolean()
    If onSale Then
      Console.WriteLine(reader("productID"))
    End If
  Loop While reader.ReadToNextSibling("item")
          
End Using

En el ejemplo se utiliza como entrada el archivo dataFile_2.xml.

<root>
  <item sale-item='true' productID='123456' colors='blue green black'>
    <price>9.95</price>
  </item>
  <item sale-item='false' productID='124390'>
    <price>5.95</price>
  </item>
  <item sale-item='true' productID='53298'>
    <price>12.95</price>
  </item>
</root>

Comentarios

Este método concatena texto, espacios en blanco, espacios en blanco significativos y secciones CDATA, y omite los comentarios o las instrucciones de procesamiento. Las referencias de entidad se resuelven automáticamente.

Si el contenido se escribe xsd:boolean, el lector devuelve un objeto sin conversión boxing Boolean . Si el contenido no está escrito xsd:boolean, el lector intenta convertirlo en un Boolean objeto según las reglas definidas por la recomendación W3C XML Schema Part 2: Datatypes .

En la tabla siguiente se describe cómo trata este método cada tipo de nodo.

Tipo XmlNode Valor devuelto Comportamiento del sistema de lectura
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
El contenido concatenado de los nodos de texto, CDATA, espacio en blanco y espacio en blanco significativo se convierten en el tipo solicitado. Se mueve a la siguiente etiqueta del elemento de inicio o de fin. Las referencias de entidad se expanden automáticamente.
Attribute Igual que llamar a XmlConvert.ToXxx en el valor del atributo. El sistema de lectura permanece en la posición actual.
Comment

ProcessingInstruction
Omite la instrucción de procesamiento o los comentarios y lee el contenido del texto concatenado que sigue a la instrucción de procesamiento o los comentarios. Se mueve a la siguiente etiqueta del elemento de inicio o de fin. Las referencias de entidad se expanden automáticamente.
EndElement Una cadena vacía. El sistema de lectura permanece en la posición actual.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Se inicia una InvalidOperationException. No definido, aunque normalmente el sistema de lectura permanece en la posición actual.

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

Se aplica a