XmlReader.ReadElementContentAsString 메서드

정의

네임스페이스:

System.Xml

어셈블리:

netstandard.dll, System.Xml.ReaderWriter.dll

현재 요소를 읽고 내용을 개체로 String 반환합니다.

오버로드

Name	Description
ReadElementContentAsString(String, String)	지정된 로컬 이름 및 네임스페이스 URI가 현재 요소의 이름과 일치하는지 확인한 다음, 현재 요소를 읽고 내용을 개체로 String 반환합니다.
ReadElementContentAsString()	현재 요소를 읽고 내용을 개체로 String 반환합니다.

ReadElementContentAsString(String, String)

Source:

XmlReader.cs

지정된 로컬 이름 및 네임스페이스 URI가 현재 요소의 이름과 일치하는지 확인한 다음, 현재 요소를 읽고 내용을 개체로 String 반환합니다.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);

public virtual string ReadElementContentAsString(string localName, string namespaceURI);

abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string

Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

매개 변수

localName

String

요소의 로컬 이름입니다.

namespaceURI

String

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

반품

String

개체로서의 요소 콘텐츠입니다 String .

예외

InvalidOperationException

XmlReader 요소에 위치하지 않습니다.

-또는-

XmlReader 이전 비동기 작업이 완료되기 전에 메서드가 호출되었습니다. 이 경우 InvalidOperationException "비동기 작업이 이미 진행 중입니다."라는 메시지와 함께 throw됩니다.

XmlException

현재 요소에는 자식 요소가 포함됩니다.

-또는-

요소 콘텐츠를 개체로 변환할 String 수 없습니다.

ArgumentNullException

메서드는 인수를 사용하여 null 호출됩니다.

ArgumentException

지정된 로컬 이름 및 네임스페이스 URI가 읽는 현재 요소의 이름과 일치하지 않습니다.

예제

다음 예제에서는 요소를 읽고 stringValue 텍스트 콘텐츠를 반환합니다(주석 및 처리 명령 무시).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
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: 데이터 형식 권장 사항을 참조하세요 .

ReadElementContentAsString()

Source:

XmlReader.cs

현재 요소를 읽고 내용을 개체로 String 반환합니다.

public:
 virtual System::String ^ ReadElementContentAsString();

public virtual string ReadElementContentAsString();

abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string

Public Overridable Function ReadElementContentAsString () As String

반품

String

개체로서의 요소 콘텐츠입니다 String .

예외

InvalidOperationException

XmlReader 요소에 위치하지 않습니다.

-또는-

XmlReader 이전 비동기 작업이 완료되기 전에 메서드가 호출되었습니다. 이 경우 InvalidOperationException "비동기 작업이 이미 진행 중입니다."라는 메시지와 함께 throw됩니다.

XmlException

현재 요소에는 자식 요소가 포함됩니다.

-또는-

요소 콘텐츠를 개체로 변환할 String 수 없습니다.

ArgumentNullException

메서드는 인수를 사용하여 null 호출됩니다.

예제

다음 예제에서는 요소를 읽고 stringValue 텍스트 콘텐츠를 반환합니다(주석 및 처리 명령 무시).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
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: 데이터 형식 권장 사항을 참조하세요 .

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