다음을 통해 공유

XmlReader.ReadElementContentAs 메서드

  • 참조

정의

네임스페이스:
System.Xml
어셈블리:
System.Xml.ReaderWriter.dll
어셈블리:
System.Xml.dll
어셈블리:
netstandard.dll

현재 요소를 읽고 콘텐츠를 지정된 형식의 개체로 반환합니다.

오버로드

ReadElementContentAs(Type, IXmlNamespaceResolver)

요소 콘텐츠를 요청된 형식으로 읽습니다.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

지정된 로컬 이름과 네임스페이스 URI가 현재 요소의 로컬 이름 및 네임스페이스 URI와 일치하는지 확인한 다음 요소 콘텐츠를 요청된 형식으로 읽습니다.

ReadElementContentAs(Type, IXmlNamespaceResolver)

요소 콘텐츠를 요청된 형식으로 읽습니다.

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

매개 변수

returnType
Type

반환될 값의 형식입니다.

참고 .NET Framework 3.5 릴리스에서는 returnType 매개 변수 값이 DateTimeOffset 형식이 될 수 있습니다.

namespaceResolver
IXmlNamespaceResolver

형식 변환과 관련된 모든 네임스페이스 접두사를 확인하는 IXmlNamespaceResolver 개체입니다.

반환

Object

요청된 형식의 개체로 변환된 요소 콘텐츠입니다.

예외

InvalidOperationException

XmlReader가 요소에 배치되지 않은 경우

또는

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

XmlException

현재 요소에 자식 요소가 포함된 경우

또는

요소 콘텐츠를 요청한 형식으로 변환할 수 없는 경우

ArgumentNullException

메서드가 null 인수를 사용하여 호출된 경우

OverflowException

Decimal.MaxValue를 읽는 경우

예제

다음 예제에서는 메서드를 ReadElementContentAs 사용하여 노드의 내용을 읽습니다 date .

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 파일을 입력으로 사용합니다.

<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>

설명

이 메서드는 시작 태그, 요소의 내용을 읽고 판독기를 끝 요소 태그를 지나 이동합니다. 엔터티를 확장하고 처리 지침 및 주석을 무시합니다. 요소는 단순 콘텐츠만 포함할 수 있습니다. 즉, 자식 요소를 가질 수 없습니다.

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

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

적용 대상

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

지정된 로컬 이름과 네임스페이스 URI가 현재 요소의 로컬 이름 및 네임스페이스 URI와 일치하는지 확인한 다음 요소 콘텐츠를 요청된 형식으로 읽습니다.

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

매개 변수

returnType
Type

반환될 값의 형식입니다.

참고 .NET Framework 3.5 릴리스에서는 returnType 매개 변수 값이 DateTimeOffset 형식이 될 수 있습니다.

namespaceResolver
IXmlNamespaceResolver

형식 변환과 관련된 모든 네임스페이스 접두사를 확인하는 IXmlNamespaceResolver 개체입니다.

localName
String

요소의 로컬 이름입니다.

namespaceURI
String

요소의 네임스페이스 URI입니다.

반환

Object

요청된 형식의 개체로 변환된 요소 콘텐츠입니다.

예외

InvalidOperationException

XmlReader가 요소에 배치되지 않은 경우

또는

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

XmlException

현재 요소에 자식 요소가 포함된 경우

또는

요소 콘텐츠를 요청한 형식으로 변환할 수 없는 경우

ArgumentNullException

메서드가 null 인수를 사용하여 호출된 경우

ArgumentException

지정한 로컬 이름과 네임스페이스 URI가 읽고 있는 현재 요소의 로컬 이름 및 네임스페이스 URI와 일치하지 않는 경우

OverflowException

Decimal.MaxValue를 읽는 경우

설명

이 메서드는 시작 태그, 요소의 내용을 읽고 판독기를 끝 요소 태그를 지나 이동합니다. 엔터티를 확장하고 처리 지침 및 주석을 무시합니다. 요소는 단순 콘텐츠만 포함할 수 있습니다. 즉, 자식 요소를 가질 수 없습니다.

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

적용 대상