XmlReader.ReadContentAsBoolean Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Odczytuje zawartość tekstową w bieżącym położeniu 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

Zwraca

Boolean

Zawartość tekstowa Boolean jako obiekt.

Wyjątki

InvalidCastException

Próba rzutowania jest nieprawidłowa.

FormatException

Format ciągu jest nieprawidłowy.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

W poniższym przykładzie użyto ReadContentAsBoolean metody do odczytania atrybutu Boolean jako wartości.

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

W przykładzie użyto dataFile_2.xml pliku jako danych wejściowych.

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

Uwagi

Ta metoda łączy tekst, białe znaki, znaczące białe znaki i sekcje CDATA oraz pomija wszelkie komentarze lub instrukcje przetwarzania. Odwołania do jednostek są automatycznie rozwiązywane.

Jeśli zawartość jest typowana xsd:boolean, czytnik zwraca obiekt rozpboxowany Boolean . Jeśli zawartość nie jest wpisywana xsd:boolean, czytelnik próbuje przekonwertować go na Boolean obiekt zgodnie z regułami zdefiniowanymi przez zalecenie schematu XML W3C Part 2: Datatypes .

W poniższej tabeli opisano sposób traktowania poszczególnych typów węzłów przez tę metodę.

XmlNodeType	Wartość zwracana	Zachowanie czytelnika
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Połączona zawartość tekstu, CDATA, biały znak i znaczące węzły odstępu przekonwertowane na żądany typ.	Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
Attribute	Tak samo jak wywołanie XmlConvert.ToXxx wartości atrybutu.	Czytelnik pozostaje w bieżącej pozycji.
Comment ProcessingInstruction	Ignoruje instrukcję przetwarzania (PI) lub komentarz i odczytuje połączoną zawartość tekst, która następuje po pi lub komentarzu.	Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
EndElement	Pusty ciąg.	Czytelnik pozostaje w bieżącej pozycji.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Jest InvalidOperationException zgłaszany.	Niezdefiniowany, chociaż zazwyczaj czytelnik pozostaje w bieżącej pozycji.

Aby uzyskać więcej informacji, zobacz stronę referencyjną XmlReader i zalecenie schematu XML W3C Part 2: Datatypes .