다음을 통해 공유


XmlReader.ReadContentAsString 메서드

정의

현재 위치의 텍스트 콘텐츠를 String 개체로 읽습니다.

public:
 virtual System::String ^ ReadContentAsString();
public virtual string ReadContentAsString ();
abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string
Public Overridable Function ReadContentAsString () As String

반환

String

텍스트 콘텐츠에 해당하는 String 개체입니다.

예외

시도된 캐스팅이 잘못된 경우

문자열 형식이 올바르지 않은 경우

이전 비동기 작업이 완료되기 전에 XmlReader 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

설명

이 메서드는 텍스트, 공백, 상당한 공백 및 CDATA 섹션을 결합하고 주석 또는 처리 지침을 건너뜁니다. 엔터티 참조는 자동으로 확인됩니다.

이 메서드는 입력된 값을 문자열로 변환하거나 주석 및 처리 지침을 건너뛰는 동안 텍스트 콘텐츠를 읽는 데 사용할 수 있습니다.

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

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 됩니다. 일반적으로 판독기는 현재 위치에 유지되지만 정의되지 않습니다.

자세한 내용은 참조 페이지의 설명 섹션 XmlReaderW3C XML 스키마 파트 2: Datatypes 권장 사항을 참조하세요 .

이 메서드의 비동기 버전은 다음을 참조하세요 ReadContentAsStringAsync.

적용 대상