Metodo XmlReader.ReadContentAsBoolean (System.Xml)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Metodo XmlReader.ReadContentAsBoolean

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Legge il contenuto di testo nella posizione corrente come Boolean.

Spazio dei nomi: System.Xml
Assembly: System.Xml (in system.xml.dll)

Sintassi
Visual Basic - (Dichiarazione)
Public Overridable Function ReadContentAsBoolean As Boolean
Visual Basic (Utilizzo)
Dim instance As XmlReader
Dim returnValue As Boolean

returnValue = instance.ReadContentAsBoolean
C#
public virtual bool ReadContentAsBoolean ()
C++
public:
virtual bool ReadContentAsBoolean ()
J#
public boolean ReadContentAsBoolean ()
JScript
public function ReadContentAsBoolean () : boolean

Valore restituito

Contenuto di testo come oggetto Boolean.
Eccezioni
Tipo di eccezione Condizione

InvalidCastException

Il tentativo di cast non è valido.

FormatException

Il formato della stringa non è valido.
Note

In questo metodo vengono concatenati testo, spazio vuoto, spazio vuoto significativo e sezioni CDATA e vengono ignorati commenti o istruzioni di elaborazione. I riferimenti a entità vengono risolti automaticamente.

Se il contenuto è xsd:boolean tipizzato, il visualizzatore restituisce un oggetto Boolean unboxed. Se il contenuto non è xsd:boolean tipizzato, il visualizzatore tenta di convertirlo in un oggetto Boolean in base alle regole definite nella raccomandazione W3C XML Schema Part 2: Datatypes, disponibili all'indirizzo http://www.w3.org/TR/xmlschema-2/ (informazioni in lingua inglese).

Nella tabella riportata di seguito viene illustrato come viene considerato ogni tipo di nodo dal metodo.

XmlNodeType

Valore restituito

Comportamento del visualizzatore

Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity

Contenuto concatenato di nodi testo, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto.

Consente di spostare il successivo tag dell'elemento iniziale o finale. I riferimenti a entità vengono espansi automaticamente.

Attribute

Equivale a chiamare XmlConvert.ToXxx nel valore dell'attributo.

Il visualizzatore 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.

Consente di spostare il successivo tag dell'elemento iniziale o finale. I riferimenti a entità vengono espansi automaticamente.

EndElement

Stringa vuota.

Il visualizzatore resta nella posizione corrente.

Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment

Viene generata un'InvalidOperationException.

Non definito, sebbene in genere il visualizzatore resti nella posizione corrente.

Per ulteriori informazioni, vedere Lettura di dati tipizzati e la raccomandazione W3C XML Schema Part 2: Datatypes all'indirizzo http://www.w3.org/TR/xmlschema-2/ (informazioni in lingua inglese).

Esempio

Nell'esempio riportato di seguito viene utilizzato il metodo ReadContentAsBoolean per leggere l'attributo come valore Boolean.

Visual Basic
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
C#
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"));    
}

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

Informazioni sulla versione

.NET Framework

Supportato in: 2.0

.NET Compact Framework

Supportato in: 2.0
Vedere anche