XmlReader.ReadContentAsBoolean Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Lê o conteúdo de texto na posição atual como um 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
Retornos
O conteúdo de texto como um objeto Boolean.
Exceções
A tentativa de conversão não é válida.
O formato da cadeia de caracteres não é válido.
Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.
Exemplos
O exemplo a seguir usa o ReadContentAsBoolean método para ler o atributo como um 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
O exemplo usa o arquivo dataFile_2.xml
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>
Comentários
Esse método concatena o texto, o espaço em branco, o espaço em branco significativo e as seções CDATA e ignora quaisquer comentários ou instruções de processamento. As referências de entidade são resolvidas automaticamente.
Se o conteúdo for digitado xsd:boolean
, o leitor retornará um objeto sem caixa Boolean . Se o conteúdo não for digitado xsd:boolean
, o leitor tentará convertê-lo em um Boolean objeto de acordo com as regras definidas pela recomendação W3C XML Schema Part 2: Datatypes .
A tabela a seguir descreve como esse método trata cada tipo de nó.
XmlNodeType | Valor retornado | Comportamento do leitor |
---|---|---|
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity |
Concatenado conteúdo de texto, de CDATA, de espaço em branco e os nós significativos de espaço em branco convertidos para o tipo solicitado. | Move para a seguir marca de início ou elemento de extremidade. Referências a entidades são automaticamente expandidas. |
Attribute |
O mesmo que chamar XmlConvert.ToXxx no valor do atributo. |
O leitor permanece na posição atual. |
Comment ProcessingInstruction |
Ignora a instrução de processamento (PI) ou o comentário e ler o conteúdo concatenado de texto que segue o PI ou o comentário. | Move para a seguir marca de início ou elemento de extremidade. Referências a entidades são automaticamente expandidas. |
EndElement |
Uma cadeia de caracteres vazia. | O leitor permanece na posição atual. |
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment |
InvalidOperationException é lançada. | Indefinido, embora geralmente o leitor permaneça na posição atual. |
Para obter mais informações, consulte a XmlReader página de referência e a recomendação W3C XML Schema Part 2: Datatypes .