XmlReader.ReadContentAsBoolean Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Kaynak:

XmlReader.cs

Geçerli konumdaki metin içeriğini olarak Booleanokur.

public:
 virtual bool ReadContentAsBoolean();

public virtual bool ReadContentAsBoolean ();

abstract member ReadContentAsBoolean : unit -> bool
override this.ReadContentAsBoolean : unit -> bool

Public Overridable Function ReadContentAsBoolean () As Boolean

Döndürülenler

Boolean

Nesne olarak Boolean metin içeriği.

Özel durumlar

InvalidCastException

Denenen atama geçerli değil.

FormatException

Dize biçimi geçerli değil.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnek özniteliğini değer Boolean olarak okumak için yöntemini kullanırReadContentAsBoolean.

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

Örnekte giriş olarak dosya kullanılır dataFile_2.xml .

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

Açıklamalar

Bu yöntem metin, boşluk, önemli boşluk ve CDATA bölümlerini birleştirir ve açıklamaları veya işleme yönergelerini atlar. Varlık başvuruları otomatik olarak çözümlenir.

İçerik yazılırsa xsd:booleanokuyucu, kutulanmamış Boolean bir nesne döndürür. İçerik yazılmamışsaxsd:boolean, okuyucu bunu W3C XML Şema Bölüm 2: Veri türleri önerisi tarafından tanımlanan kurallara göre bir Boolean nesneye dönüştürmeyi dener.

Aşağıdaki tabloda bu yöntemin her düğüm türünü nasıl eledığı açıklanmaktadır.

Xmlnodetype	Döndürülen değer	Okuyucu davranışı
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Metin, CDATA, boşluk ve önemli boşluk düğümlerinin birleştirilmiş içeriği istenen türe dönüştürülür.	Sonraki başlangıç öğesine veya bitiş öğesi etiketine geçer. Varlık başvuruları otomatik olarak genişletilir.
Attribute	Öznitelik değerini çağırmakla XmlConvert.ToXxx aynı.	Okuyucu geçerli konumda kalır.
Comment ProcessingInstruction	İşleme yönergesini (PI) veya açıklamayı yoksayar ve PI veya açıklamayı izleyen birleştirilmiş metin içeriğini okur.	Sonraki başlangıç öğesine veya bitiş öğesi etiketine geçer. Varlık başvuruları otomatik olarak genişletilir.
EndElement	Boş bir dize.	Okuyucu geçerli konumda kalır.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	bir InvalidOperationException atılır.	Tanımlanmamış olsa da, okuyucu genellikle geçerli konumda kalır.

Daha fazla bilgi için başvuru sayfasına ve W3C XML Şema Bölüm 2: Veri türleri önerisine bakınXmlReader.