XmlReader.ReadContentAsBoolean Метод

Определение

Считывает содержимое текста в текущей позиции как значение 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

Возвращаемое значение

Текстовое содержимое в виде объекта Boolean.The text content as a Boolean object.

Исключения

Недопустимая попытка приведения.The attempted cast is not valid.

Недопустимый формат строки.The string format is not valid.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Примеры

В следующем примере используется метод ReadContentAsBoolean для чтения атрибута как значения 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

В примере в качестве входных данных используется файл dataFile_2.xml.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>

Комментарии

Этот метод объединяет текст, пробел, значащий пробел и разделы CDATA и пропускает все комментарии и инструкции по обработке.This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. Ссылки на сущности разрешаются автоматически.Entity references are automatically resolved.

Если содержимое введено xsd:boolean, средство чтения возвращает неупакованный Boolean объект.If the content is typed xsd:boolean, the reader returns an unboxed Boolean object. Если содержимое не типизировано xsd:boolean, модуль чтения пытается преобразовать его в объект Boolean в соответствии с правилами, определенными в рекомендациях консорциума W3C по схеме XML, часть 2: типы данных.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.

В следующей таблице описано, как этот метод обрабатывает каждый тип узла.The following table describes how this method treats each node type.

Тип узла XMLXmlNodeType Возвращаемое значениеReturn value Поведение модуля чтенияReader behavior
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Объединенное содержимое узлов текста, CDATA, пробелов и значимых пробелов, преобразованное в необходимый тип.Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. Перемещается к следующему тегу начального или конечного элемента.Moves to the next start element or end element tag. Ссылки на сущности автоматически раскрываются.Entity references are automatically expanded.
Attribute Аналогично вызову XmlConvert.ToXxx для значения атрибута.Same as calling XmlConvert.ToXxx on the attribute value. Средство чтения остается в текущей позиции.The reader remains in the current position.
Comment

ProcessingInstruction
Пропускает инструкцию по обработке или комментарий и считывает объединенное текстовое содержимое, следующее за инструкцией по обработке или комментарием.Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. Перемещается к следующему тегу начального или конечного элемента.Moves to the next start element or end element tag. Ссылки на сущности автоматически раскрываются.Entity references are automatically expanded.
EndElement Пустая строка.An empty string. Средство чтения остается в текущей позиции.The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Возникает исключение InvalidOperationException.An InvalidOperationException is thrown. Не определено, хотя обычно модуль чтения остается в текущей позиции.Undefined, although typically the reader remains in the current position.

Дополнительные сведения см. на странице справочника по XmlReader и рекомендации консорциума W3C по XML-схеме часть 2: типы данных.For more information, see the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Применяется к