XmlReader.ReadElementContentAs Method

Definition

현재 요소를 읽고 콘텐츠를 지정된 형식의 개체로 반환합니다.Reads the current element and returns the contents as an object of the type specified.

Overloads

ReadElementContentAs(Type, IXmlNamespaceResolver)

요소 콘텐츠를 요청된 형식으로 읽습니다.Reads the element content as the requested type.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

지정된 로컬 이름과 네임스페이스 URI가 현재 요소의 로컬 이름 및 네임스페이스 URI와 일치하는지 확인한 다음 요소 콘텐츠를 요청된 형식으로 읽습니다.Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

ReadElementContentAs(Type, IXmlNamespaceResolver)

요소 콘텐츠를 요청된 형식으로 읽습니다.Reads the element content as the requested type.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);
public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);
abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parameters

returnType
Type

반환될 값의 형식입니다.The type of the value to be returned.

참고 .NET Framework 3.5 릴리스에서는 returnType 매개 변수 값이 DateTimeOffset 형식이 될 수 있습니다.Note With the release of the .NET Framework 3.5, the value of the returnType parameter can now be the DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver

형식 변환과 관련된 모든 네임스페이스 접두사를 확인하는 IXmlNamespaceResolver 개체입니다.An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

Returns

Object

요청된 형식의 개체로 변환된 요소 콘텐츠입니다.The element content converted to the requested typed object.

Exceptions

XmlReader가 요소에 배치되지 않은 경우The XmlReader is not positioned on an element.

-또는--or-

이전 비동기 작업이 완료되기 전에 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."

현재 요소에 자식 요소가 있습니다.The current element contains child elements.

-또는--or-

요소 콘텐츠에 해당 하는 요청된 된 형식으로 변환할 수 없습니다.The element content cannot be converted to the requested type.

메서드가 null 인수를 사용하여 호출된 경우The method is called with null arguments.

Decimal.MaxValue를 읽는 경우Read Decimal.MaxValue.

Examples

다음 예제에서는 ReadElementContentAs 메서드를 사용 하 여 date 노드의 내용을 읽습니다.The following example uses the ReadElementContentAs method to read the content of the date node.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

이 예제에서는 dataFile.xml 파일을 입력으로 사용합니다.The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Remarks

이 메서드는 시작 태그를 요소의 내용을 읽고 끝 요소 태그를 지나서 판독기를 이동 합니다.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. 엔터티를 확장 하 고 처리 명령과 주석을 무시 합니다.It expands entities and ignores processing instructions and comments. 요소는 단순 콘텐츠가 포함할 수 있습니다.The element can only contain simple content. 즉, 자식 요소가 없습니다.That is, it cannot have child elements.

자세한 내용은 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.

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

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

지정된 로컬 이름과 네임스페이스 URI가 현재 요소의 로컬 이름 및 네임스페이스 URI와 일치하는지 확인한 다음 요소 콘텐츠를 요청된 형식으로 읽습니다.Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);
public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);
abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Parameters

returnType
Type

반환될 값의 형식입니다.The type of the value to be returned.

참고 .NET Framework 3.5 릴리스에서는 returnType 매개 변수 값이 DateTimeOffset 형식이 될 수 있습니다.Note With the release of the .NET Framework 3.5, the value of the returnType parameter can now be the DateTimeOffset type.

namespaceResolver
IXmlNamespaceResolver

형식 변환과 관련된 모든 네임스페이스 접두사를 확인하는 IXmlNamespaceResolver 개체입니다.An IXmlNamespaceResolver object that is used to resolve any namespace prefixes related to type conversion.

localName
String

요소의 로컬 이름입니다.The local name of the element.

namespaceURI
String

요소의 네임스페이스 URI입니다.The namespace URI of the element.

Returns

Object

요청된 형식의 개체로 변환된 요소 콘텐츠입니다.The element content converted to the requested typed object.

Exceptions

XmlReader가 요소에 배치되지 않은 경우The XmlReader is not positioned on an element.

-또는--or-

이전 비동기 작업이 완료되기 전에 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."

현재 요소에 자식 요소가 있습니다.The current element contains child elements.

-또는--or-

요소 콘텐츠에 해당 하는 요청된 된 형식으로 변환할 수 없습니다.The element content cannot be converted to the requested type.

메서드가 null 인수를 사용하여 호출된 경우The method is called with null arguments.

지정 된 로컬 이름과 네임 스페이스 URI 읽고 있는 현재 요소는 일치 하지 않습니다.The specified local name and namespace URI do not match that of the current element being read.

Decimal.MaxValue를 읽는 경우Read Decimal.MaxValue.

Remarks

이 메서드는 시작 태그를 요소의 내용을 읽고 끝 요소 태그를 지나서 판독기를 이동 합니다.This method reads the start tag, the contents of the element, and moves the reader past the end element tag. 엔터티를 확장 하 고 처리 명령과 주석을 무시 합니다.It expands entities and ignores processing instructions and comments. 요소는 단순 콘텐츠가 포함할 수 있습니다.The element can only contain simple content. 즉, 자식 요소가 없습니다.That is, it cannot have child elements.

자세한 내용은 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.

Applies to