XmlReader.ReadContentAsString Method

Definition

현재 위치의 텍스트 콘텐츠를 String 개체로 읽습니다.Reads the text content at the current position as a String object.

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

Returns

String

텍스트 콘텐츠에 해당하는 String 개체입니다.The text content as a String 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."

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.

이 메서드를 사용할 수를 문자열로 또는 주석을 건너뛰고 처리 명령 하는 동안 텍스트 콘텐츠를 읽기 위해 형식화 된 값을 변환 합니다.This method can be used convert typed values to a string, or to read the text content while skipping comments and processing instructions.

다음 표에이 메서드가 각 노드 형식을 처리 하는 방법을 보여 줍니다.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 Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

이 메서드의 비동기 버전은 ReadContentAsStringAsync를 참조 하세요.For the asynchronous version of this method, see ReadContentAsStringAsync.

Applies to