XmlReader.ReadContentAsBoolean Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

Přečte textový obsah na aktuální pozici jako 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

Návraty

Boolean

Textový obsah jako Boolean objekt.

Výjimky

InvalidCastException

Pokus o přetypování není platný.

FormatException

Formát řetězce není platný.

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

Příklady

Následující příklad používá metodu ReadContentAsBoolean ke čtení atributu jako Boolean hodnoty.

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

V příkladu se dataFile_2.xml jako vstup používá soubor.

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

Poznámky

Tato metoda zřetězí text, prázdné znaky, významné prázdné znaky a oddíly CDATA a přeskočí všechny komentáře nebo pokyny ke zpracování. Odkazy na entity se automaticky přeloží.

Pokud je obsah zadán xsd:boolean, čtečka vrátí objekt bez polí.Boolean Pokud obsah není zadán xsd:boolean, čtenář se ho pokusí převést na Boolean objekt podle pravidel definovaných schématem XML W3C Část 2: Doporučení datových typů .

Následující tabulka popisuje, jak tato metoda zachází s jednotlivými typy uzlů.

Xmlnodetype	Vrácená hodnota	Chování čtenáře
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Zřetězený obsah textu, CDATA, prázdných znaků a významných prázdných uzlů převedených na požadovaný typ.	Přesune se na další značku start elementu nebo koncového elementu. Odkazy na entity se automaticky rozbalí.
Attribute	Stejné jako volání XmlConvert.ToXxx na hodnotu atributu.	Čtečka zůstane na aktuální pozici.
Comment ProcessingInstruction	Ignoruje instrukce zpracování (PI) nebo komentář a přečte obsah zřetězeného textu, který následuje za pi nebo komentářem.	Přesune se na další značku start elementu nebo koncového elementu. Odkazy na entity se automaticky rozbalí.
EndElement	Prázdný řetězec.	Čtečka zůstane na aktuální pozici.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Vyhodí InvalidOperationException se.	Nedefinováno, i když čtečka obvykle zůstává v aktuální pozici.

Další informace najdete na XmlReader stránce s referenčními informacemi a v části 2 schématu XML W3C: Doporučení datových typů .