XmlReader.ReadContentAsObject 메서드

정의

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

텍스트 콘텐츠에 해당하는 가장 적절한 CLR(공용 언어 런타임) 개체입니다.

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

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

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

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

콘텐츠가 형식화되면 판독기는 속성에 지정된 가장 적합한 형식의 박스형 CLR을 ValueType 반환합니다. 콘텐츠가 목록 형식인 경우 판독기는 적절한 형식의 boxed 개체 배열을 반환합니다.

참고

콘텐츠를 구문 분석하는 동안 유효성 검사 오류가 발생하고 판독기는 메서드에서 Create 만든 개체인 XmlReader 경우 콘텐츠를 문자열로 반환합니다. 즉, 유효성 검사 오류 또는 경고가 발생하면 콘텐츠가 형식화되지 않은 것으로 간주됩니다.

콘텐츠가 형식화되지 않은 경우 판독기는 콘텐츠를 문자열로 반환합니다.

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

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

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