XmlReader.ReadContentAsBoolean Metoda

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Zdroj:: XmlReader.cs

Zdroj:: XmlReader.cs

Zdroj:: XmlReader.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Platí pro

Sdílet prostřednictvím