XmlReader.ReadContentAsObject Method

Definition

현재 위치의 텍스트 콘텐츠를 Object로 읽습니다.Reads the text content at the current position as an Object.

public:
 virtual System::Object ^ ReadContentAsObject();
public virtual object ReadContentAsObject ();
abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj
Public Overridable Function ReadContentAsObject () As Object

Returns

Object

텍스트 콘텐츠에 해당하는 가장 적합한 CLR(공용 언어 런타임) 개체입니다.The text content as the most appropriate common language runtime (CLR) 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.

콘텐츠를 입력 하는 경우 판독기는 ValueType 속성으로 지정 된 가장 적절 한 형식의 boxed CLR을 반환 합니다.If the content is typed, the reader returns a boxed CLR of the most appropriate type, specified by the ValueType property. 콘텐츠 목록 형식이 면 판독기는 적절 한 형식의 boxed 개체의 배열을 반환 합니다.If the content is a list type, the reader returns an array of boxed objects of the appropriate type.

Note

콘텐츠를 구문 분석 하는 동안 유효성 검사 오류가 발생 하 고 판독기가 Create 메서드에서 만든 XmlReader 개체인 경우 판독기는 콘텐츠를 문자열로 반환 합니다.If a validation error occurs while parsing the content and the reader is an XmlReader object created by the Create method, the reader returns the content as a string. 즉 유효성 검사 오류나 경고가 발생할 때 콘텐츠 비율은 형식화 되지 않아야 합니다.In other words when a validation error or warning occurs, the content is considered to be untyped.

형식화되지 않은 내용의 경우 판독기가 해당 내용을 문자열로 반환합니다.If the content is not typed, the reader returns the content as a string.

다음 표에이 메서드가 각 노드 형식을 처리 하는 방법을 보여 줍니다.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 판독기가 스키마 유효성 검사 판독기 인 경우 요소의 값입니다 (ValidationType Schema로 설정 됨). 그렇지 않으면 빈 문자열입니다.The value of the element if the reader is a schema validating reader (ValidationType is set to Schema); otherwise 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.

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

Applies to