XmlReader.ReadContentAsBoolean Método

Definição

Namespace:

System.Xml

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlReader.cs

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 -> bool

Public Overridable Function ReadContentAsBoolean () As Boolean

Retornos

Boolean

O conteúdo do texto como um Boolean objeto.

Exceções

InvalidCastException

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

FormatException

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

InvalidOperationException

Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada 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 dataFile_2.xml arquivo 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 qualquer comentário 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 de retorno	Comportamento do leitor
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Conteúdo concatenado de texto, CDATA, espaço em branco e nós de espaço em branco significativos convertidos no tipo solicitado.	Move para o próximo elemento inicial ou marca de elemento final. As referências de entidade são expandidas automaticamente.
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 lê o conteúdo de texto concatenado que segue o PI ou o comentário.	Move para o próximo elemento inicial ou marca de elemento final. As referências de entidade são expandidas automaticamente.
EndElement	Uma cadeia de caracteres vazia.	O leitor permanece na posição atual.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Um InvalidOperationException é lançado.	Indefinido, embora normalmente 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 .