XmlReader.ReadContentAsBoolean Método

Referência

Definição

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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

Boolean

O conteúdo de texto como um objeto Boolean.

Exceções

InvalidCastException

A tentativa de conversão não é válida.

FormatException

O formato da cadeia de caracteres não é válido.

InvalidOperationException

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

Compartilhar via