Sdílet prostřednictvím


XmlReader.ReadContentAsBoolean Metoda

Definice

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

Textový obsah jako Boolean objekt.

Výjimky

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

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

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

Platí pro