XmlReader.ReadContentAsBoolean XmlReader.ReadContentAsBoolean XmlReader.ReadContentAsBoolean XmlReader.ReadContentAsBoolean Method

Definizione

Legge il contenuto di testo nella posizione corrente come Boolean.Reads the text content at the current position as a 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

Restituisce

Contenuto di testo come oggetto Boolean.The text content as a Boolean object.

Eccezioni

Il tentativo di cast non è valido.The attempted cast is not valid.

Il formato della stringa non è valido.The string format is not valid.

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Esempi

L'esempio seguente usa il ReadContentAsBoolean metodo per leggere l'attributo come un Boolean valore.The following example uses the ReadContentAsBoolean method to read the attribute as a Boolean value.

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

Nell'esempio viene utilizzato il file dataFile_2.xml come input.The example uses the dataFile_2.xml file as input.

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

Commenti

Questo metodo consente di concatenare testo, gli spazi vuoti, gli spazi vuoti significativi e le sezioni CDATA e ignora eventuali commenti o istruzioni di elaborazione.This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. I riferimenti alle entità vengono risolti automaticamente.Entity references are automatically resolved.

Se il contenuto è tipizzato xsd:boolean, il lettore di testo restituisce un tipo unboxed Boolean oggetto.If the content is typed xsd:boolean, the reader returns an unboxed Boolean object. Se il contenuto non è tipizzato xsd:boolean, il lettore tenta di convertirlo in un Boolean oggetto in base alle regole definite nella raccomandazione di W3C XML Schema Part 2: Tipi di dati raccomandazione.If the content is not typed xsd:boolean, the reader attempts to convert it to a Boolean object according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

La tabella seguente descrive come questo metodo considera ogni tipo di nodo.The following table describes how this method treats each node type.

XmlNodeTypeXmlNodeType Valore restituitoReturn value Comportamento del lettoreReader behavior
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Contenuto concatenato di nodi di tipo text, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto.Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. Si sposta al successivo tag di fine o di inizio dell'elemento.Moves to the next start element or end element tag. I riferimenti a entità vengono espansi automaticamente.Entity references are automatically expanded.
Attribute Equivale a chiamare XmlConvert.ToXxx sul valore dell'attributo.Same as calling XmlConvert.ToXxx on the attribute value. Il lettore resta nella posizione corrente.The reader remains in the current position.
Comment

ProcessingInstruction
Ignora l'istruzione di elaborazione (PI, Processing Instruction) o il commento e legge il contenuto del testo concatenato successivo all'istruzione di elaborazione o al commento.Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. Si sposta al successivo tag di fine o di inizio dell'elemento.Moves to the next start element or end element tag. I riferimenti a entità vengono espansi automaticamente.Entity references are automatically expanded.
EndElement Stringa vuota.An empty string. Il lettore resta nella posizione corrente.The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Viene generato un tipo InvalidOperationException.An InvalidOperationException is thrown. Non definito, sebbene in genere il lettore resti nella posizione corrente.Undefined, although typically the reader remains in the current position.

Per altre informazioni, vedere la XmlReader pagina di riferimento e il W3C XML Schema Part 2: Tipi di dati raccomandazione.For more information, see the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Si applica a