XmlReader.ReadContentAsBoolean Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Legge il contenuto di testo nella posizione corrente come 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

Boolean

Contenuto di testo come oggetto Boolean.

Eccezioni

InvalidCastException

Il tentativo di cast non è valido.

FormatException

Il formato della stringa non è valido.

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

Nell'esempio seguente viene usato il metodo per leggere l'attributo ReadContentAsBoolean come Boolean valore.

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.

<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 concatena il testo, lo spazio vuoto, lo spazio vuoto significativo e le sezioni CDATA e ignora eventuali commenti o istruzioni di elaborazione. I riferimenti alle entità vengono risolti automaticamente.

Se il contenuto è digitato xsd:boolean, il lettore restituisce un oggetto non in Boolean arrivo. Se il contenuto non è tipizzato xsd:boolean, il lettore tenta di convertirlo in un Boolean oggetto in base alle regole definite dalla raccomandazione W3C XML Schema Parte 2: Tipi di dati .

Nella tabella seguente viene descritto il modo in cui questo metodo tratta ogni tipo di nodo.

XmlNodeType	Valore restituito	Comportamento del lettore
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	Contenuto concatenato di nodi di tipo text, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto.	Si sposta al successivo tag di fine o di inizio dell'elemento. I riferimenti a entità vengono espansi automaticamente.
`Attribute`	Uguale alla chiamata `XmlConvert.ToXxx` al valore dell'attributo.	Il lettore resta nella posizione corrente.
`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.	Si sposta al successivo tag di fine o di inizio dell'elemento. I riferimenti a entità vengono espansi automaticamente.
`EndElement`	Stringa vuota.	Il lettore resta nella posizione corrente.
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	Viene generato un tipo InvalidOperationException.	Non definito, sebbene in genere il lettore resti nella posizione corrente.

Per altre informazioni, vedere la XmlReader pagina di riferimento e la raccomandazione W3C XML Schema Part 2: Datatypes .

Si applica a