XmlReader.ReadContentAsBoolean Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlReader.cs

Beolvassa a szöveges tartalmat az aktuális pozícióban 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

Válaszok

Boolean

A szöveges tartalom objektumként Boolean .

Kivételek

InvalidCastException

A megkísérelt szereposztás érvénytelen.

FormatException

A sztring formátuma érvénytelen.

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Példák

Az alábbi példa a metódust használja az ReadContentAsBoolean attribútum értékként való beolvasásához Boolean .

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

A példa a dataFile_2.xml fájlt használja bemenetként.

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

Megjegyzések

Ez a módszer összefűzi a szöveget, a szóközt, a jelentős üres területet és a CDATA-szakaszokat, és kihagyja a megjegyzéseket és a feldolgozási utasításokat. Az entitáshivatkozások automatikusan feloldódnak.

Ha a tartalom be van állítva xsd:boolean, az olvasó egy nem beérkezett objektumot ad Boolean vissza. Ha a tartalom nincs begépelve xsd:boolean, az olvasó megpróbálja azt objektummá alakítani Boolean a W3C XML-séma 2. része: Adattípusokra vonatkozó javaslat által meghatározott szabályok szerint.

Az alábbi táblázat azt ismerteti, hogy ez a módszer hogyan kezeli az egyes csomóponttípusokat.

XmlNodeType	Visszaadott érték	Olvasói viselkedés
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	A kért típusra konvertált szöveg, CDATA, fehér terület és jelentős térközcsomópontok összefűzött tartalma.	Ugrás a következő kezdőelemre vagy végelemcímkére. Az entitáshivatkozások automatikusan ki lesznek bontva.
Attribute	Ugyanaz, mint az attribútumérték meghívása XmlConvert.ToXxx .	Az olvasó a jelenlegi helyzetben marad.
Comment ProcessingInstruction	Figyelmen kívül hagyja a feldolgozási utasítást (PI) vagy megjegyzést, és felolvassa a pi vagy megjegyzést követő összefűzött szöveges tartalmat.	Ugrás a következő kezdőelemre vagy végelemcímkére. Az entitáshivatkozások automatikusan ki lesznek bontva.
EndElement	Üres sztring.	Az olvasó a jelenlegi helyzetben marad.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Egy InvalidOperationException van dobva.	Nincs definiálva, bár az olvasó általában a jelenlegi helyzetben marad.

További információkért tekintse meg a XmlReader referencialapot és a W3C XML-séma 2. részét: Adattípusokra vonatkozó javaslatot.