Compartilhar via


XmlReader.ReadContentAsBoolean Método

Definição

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

Boolean

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 .

Aplica-se a