XmlReader.ReadElementContentAsString Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Membaca elemen saat ini dan mengembalikan konten sebagai String objek.

Overload

Nama	Deskripsi
ReadElementContentAsString(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai String objek.
ReadElementContentAsString()	Membaca elemen saat ini dan mengembalikan konten sebagai String objek.

ReadElementContentAsString(String, String)

Sumber:

XmlReader.cs

Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai String objek.

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

Parameter

localName

String

Nama lokal elemen .

namespaceURI

String

URI namespace elemen.

Mengembalikan

String

Konten elemen sebagai String objek.

Pengecualian

InvalidOperationException

XmlReader tidak diposisikan pada elemen.

-atau-

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

XmlException

Elemen saat ini berisi elemen turunan.

-atau-

Konten elemen tidak dapat dikonversi ke String objek.

ArgumentNullException

Metode ini dipanggil dengan null argumen.

ArgumentException

Nama lokal dan URI namespace yang ditentukan tidak cocok dengan elemen saat ini yang sedang dibaca.

Contoh

Contoh berikut membaca stringValue elemen dan mengembalikan konten teks (mengabaikan instruksi komentar dan pemrosesan).

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

Contohnya menggunakan dataFile.xml file sebagai 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>

Keterangan

Metode ini membaca tag mulai, konten elemen, dan memindahkan pembaca melewati tag elemen akhir. Ini memperluas entitas dan mengabaikan instruksi pemrosesan dan komentar. Elemen hanya dapat berisi konten sederhana. Artinya, tidak dapat memiliki elemen turunan.

Untuk informasi selengkapnya, lihat bagian Keterangan dari XmlReader halaman referensi dan rekomendasi Skema XML W3C Bagian 2: Jenis data .

ReadElementContentAsString()

Sumber:

XmlReader.cs

Membaca elemen saat ini dan mengembalikan konten sebagai String objek.

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

Mengembalikan

String

Konten elemen sebagai String objek.

Pengecualian

InvalidOperationException

XmlReader tidak diposisikan pada elemen.

-atau-

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

XmlException

Elemen saat ini berisi elemen turunan.

-atau-

Konten elemen tidak dapat dikonversi ke String objek.

ArgumentNullException

Metode ini dipanggil dengan null argumen.

Contoh

Contoh berikut membaca stringValue elemen dan mengembalikan konten teks (mengabaikan instruksi komentar dan pemrosesan).

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

Contohnya menggunakan dataFile.xml file sebagai 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>

Keterangan

Metode ini membaca tag mulai, konten elemen, dan memindahkan pembaca melewati tag elemen akhir. Ini memperluas entitas dan mengabaikan instruksi pemrosesan dan komentar. Elemen hanya dapat berisi konten sederhana. Artinya, tidak dapat memiliki elemen turunan.

Untuk informasi selengkapnya, lihat bagian Keterangan dari XmlReader halaman referensi dan rekomendasi Skema XML W3C Bagian 2: Jenis data .

Untuk versi asinkron dari metode ini, lihat ReadElementContentAsStringAsync.