XmlReader.ReadContentAsBoolean Method

Definition

현재 위치의 텍스트 콘텐츠를 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

Returns

Boolean

텍스트 콘텐츠에 해당하는 Boolean 개체입니다.The text content as a Boolean object.

Exceptions

시도된 캐스팅이 잘못된 경우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이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Examples

다음 예제에서는 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>

Remarks

이 메서드는 텍스트, 공백, 유효 공백 및 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형식화 된 경우 판독기는 unboxed Boolean 개체를 반환 합니다.If the content is typed xsd:boolean, the reader returns an unboxed Boolean object. 콘텐츠가 xsd:boolean형식화 되지 않은 경우 판독기는 W3C XML 스키마 파트 2: 데이터 형식 권장 사항에 정의 된 규칙에 따라 Boolean 개체로 변환 하려고 시도 합니다.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.

XmlNodeTypeXmlNodeType 반환 값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
PI(처리 명령) 또는 주석을 무시하고 PI 또는 주석 다음에 연결된 텍스트 내용을 읽습니다.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 throw 됩니다.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.

Applies to