XmlReader.ReadContentAsBoolean Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê o conteúdo do 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 -> boolPublic Overridable Function ReadContentAsBoolean () As BooleanDevoluções
O conteúdo do texto como um Boolean objeto.
Exceções
A tentativa de lançamento não é válida.
O formato da string não é válido.
Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."
Exemplos
O exemplo seguinte 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 dataFile_2.xml ficheiro 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>
Observações
Este método concatena texto, espaços em branco, espaços em branco significativos e secções CDATA, e ignora quaisquer comentários ou instruções de processamento. As referências às entidades são resolvidas automaticamente.
Se o conteúdo for digitado xsd:boolean, o leitor devolve um objeto sem caixa Boolean . Se o conteúdo não for tipado xsd:boolean, o leitor tenta convertê-lo num Boolean objeto de acordo com as regras definidas pela recomendação do Esquema XML do W3C Parte 2: Tipos de dados .
A tabela seguinte descreve como este método trata cada tipo de nó.
| XmlNodeType | Valor de retorno | Comportamento do leitor |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Conteúdo concatenado de texto, CDATA, espaços em branco e nós significativos de espaço em branco convertidos para o tipo solicitado. | Move-se para o próximo elemento inicial ou etiqueta de elemento final. As referências de entidades são automaticamente expandidas. |
Attribute |
É o mesmo que invocar XmlConvert.ToXxx o valor do atributo. |
O leitor mantém-se na posição atual. |
CommentProcessingInstruction |
Ignora a instrução de processamento (PI) ou comentário e lê o texto concatenado que segue o PI ou comentário. | Move-se para o próximo elemento inicial ou etiqueta de elemento final. As referências de entidades são automaticamente expandidas. |
EndElement |
Uma cadeia de caracteres vazia. | O leitor mantém-se na posição atual. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Um InvalidOperationException é jogado. | Indefinido, embora normalmente o leitor permaneça na posição atual. |
Para mais informações, consulte a XmlReader página de referência e a recomendação do Esquema XML do W3C Parte 2: Tipos de dados .
