XmlReader.ReadContentAsBoolean Metoda

Definicja

Odczytuje zawartość tekstową w bieżącym położeniu jako Boolean.Reads the text content at the current position as a 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

Zawartość tekstowa jako obiekt Boolean.The text content as a Boolean object.

Wyjątki

Niepoprawna wartość rzutowana jest nieprawidłowa.The attempted cast is not valid.

Format ciągu jest nieprawidłowy.The string format is not valid.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Przykłady

W poniższym przykładzie zastosowano metodę ReadContentAsBoolean, aby odczytać atrybut jako wartość Boolean.The following example uses the ReadContentAsBoolean method to read the attribute as a Boolean value.

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 jest użyty plik dataFile_2.xml jako dane wejściowe.The example uses the dataFile_2.xml file as input.

<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ły znak, znaczący biały znak i CDATA sekcje oraz pomija wszelkie komentarze lub instrukcje przetwarzania.This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. Odwołania do jednostek są automatycznie rozwiązywane.Entity references are automatically resolved.

Jeśli zawartość jest wpisana xsd:boolean, czytnik zwróci obiekt Boolean nieopakowany.If the content is typed xsd:boolean, the reader returns an unboxed Boolean object. Jeśli zawartość nie jest wpisana xsd:boolean, czytelnik próbuje skonwertować go do obiektu Boolean zgodnie z regułami zdefiniowanymi przez plik W3C XML schematu część 2: zalecenie typów danych.If the content is not typed xsd:boolean, the reader attempts to convert it to a Boolean object according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

W poniższej tabeli opisano, jak ta metoda traktuje każdy typ węzła.The following table describes how this method treats each node type.

XmlNodeTypeXmlNodeType Wartość zwracanaReturn value Zachowanie czytnikaReader behavior
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Dołączona zawartość tekstu, CDATA, białego znaku i znaczących białych węzłów konwertowanych na żądany typ.Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. Przenosi do następnego elementu początkowego lub znacznika końca elementu.Moves to the next start element or end element tag. Odwołania do jednostek są automatycznie rozszerzane.Entity references are automatically expanded.
Attribute Analogicznie jak wywołanie XmlConvert.ToXxx w wartości atrybutu.Same as calling XmlConvert.ToXxx on the attribute value. Czytnik pozostaje w bieżącym położeniu.The reader remains in the current position.
Comment

ProcessingInstruction
Ignoruje instrukcję przetwarzania (PI) lub komentarz i odczytuje zawartość połączonego tekstu, która następuje po podanej liczbie PI lub komentarz.Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. Przenosi do następnego elementu początkowego lub znacznika końca elementu.Moves to the next start element or end element tag. Odwołania do jednostek są automatycznie rozszerzane.Entity references are automatically expanded.
EndElement Ciąg pusty.An empty string. Czytnik pozostaje w bieżącym położeniu.The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Zostanie zgłoszony InvalidOperationException.An InvalidOperationException is thrown. Undefined, chociaż zazwyczaj czytnik pozostaje w bieżącym położeniu.Undefined, although typically the reader remains in the current position.

Aby uzyskać więcej informacji, zobacz stronę referencyjną XmlReader i plik W3C XML schematu część 2: rekomendacja typów danych.For more information, see the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Dotyczy