XmlReader.ReadContentAsBoolean 메서드

정의

네임스페이스:

System.Xml

어셈블리:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

현재 위치의 텍스트 내용을 .로 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

개체로서의 텍스트 내용입니다 Boolean .

예외

InvalidCastException

시도한 캐스트가 잘못되었습니다.

FormatException

문자열 형식이 잘못되었습니다.

InvalidOperationException

XmlReader 이전 비동기 작업이 완료되기 전에 메서드가 호출되었습니다. 이 경우 InvalidOperationException "비동기 작업이 이미 진행 중입니다."라는 메시지와 함께 throw됩니다.

예제

다음 예제에서는 메서드를 ReadContentAsBoolean 사용하여 특성을 값으로 읽습니다 Boolean .

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 파일을 입력으로 사용합니다.

<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 섹션을 연결하고 주석 또는 처리 지침을 건너뜁니다. 엔터티 참조는 자동으로 확인됩니다.

콘텐츠를 입력 xsd:boolean하면 판독기는 unboxed Boolean 개체를 반환합니다. 콘텐츠를 입력xsd:boolean하지 않으면 판독기는 W3C XML 스키마 파트 2: 데이터 형식 권장 사항에 정의된 규칙에 따라 개체로 변환 Boolean 하려고 시도합니다.

다음 표에서는 이 메서드가 각 노드 형식을 처리하는 방법을 설명합니다.

XmlNodeType	반환 값	판독기 동작
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	요청된 형식으로 변환된 텍스트, CDATA, 공백 및 중요한 공백 노드의 연결된 콘텐츠입니다.	다음 시작 요소 또는 끝 요소 태그로 이동합니다. 엔터티 참조는 자동으로 확장됩니다.
Attribute	특성 값을 호출 XmlConvert.ToXxx 하는 것과 같습니다.	판독기는 현재 위치에 남아 있습니다.
Comment ProcessingInstruction	PI(처리 명령) 또는 주석을 무시하고 PI 또는 주석 뒤에 연결된 텍스트 콘텐츠를 읽습니다.	다음 시작 요소 또는 끝 요소 태그로 이동합니다. 엔터티 참조는 자동으로 확장됩니다.
EndElement	빈 문자열입니다.	판독기는 현재 위치에 남아 있습니다.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	throw InvalidOperationException 됩니다.	일반적으로 판독기는 현재 위치에 남아 있지만 정의되지 않습니다.

자세한 내용은 XmlReader 참조 페이지 및 W3C XML 스키마 파트 2: 데이터 형식 권장 사항을 참조하세요.