XmlReader.ReadContentAsBoolean 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 contenido de texto en la posición actual como .Boolean
public:
virtual bool ReadContentAsBoolean();public virtual bool ReadContentAsBoolean();abstract member ReadContentAsBoolean : unit -> bool
override this.ReadContentAsBoolean : unit -> boolPublic Overridable Function ReadContentAsBoolean () As BooleanDevoluciones
Contenido de texto como un Boolean objeto .
Excepciones
La conversión intentada no es válida.
El formato de cadena no es válido.
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".
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 usa el dataFile_2.xml archivo como entrada.
<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, espacio en blanco, espacios en blanco significativos y secciones CDATA, y omite los comentarios o instrucciones de procesamiento. Las referencias de entidad se resuelven automáticamente.
Si el contenido está escrito xsd:boolean, el lector devuelve un objeto noboxado 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 este método trata cada tipo de nodo.
| XmlNodeType | Valor de retorno | Comportamiento del lector |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Contenido concatenado de texto, CDATA, espacio en blanco y nodos de espacio en blanco significativos convertidos al tipo solicitado. | Se mueve a la siguiente etiqueta de elemento de inicio o elemento final. Las referencias de entidad se expanden automáticamente. |
Attribute |
Igual que llamar al XmlConvert.ToXxx valor del atributo. |
El lector permanece en la posición actual. |
CommentProcessingInstruction |
Omite la instrucción de procesamiento (PI) o el comentario y lee el contenido de texto concatenado que sigue al PI o comentario. | Se mueve a la siguiente etiqueta de elemento de inicio o elemento final. Las referencias de entidad se expanden automáticamente. |
EndElement |
Una cadena vacía. | El lector permanece en la posición actual. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Se produce una InvalidOperationException excepción . | Sin definir, aunque normalmente el lector 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 W3C Parte 2: Tipos de datos .
