XmlReader.ReadElementContentAsString Yöntem

Tanım

Geçerli öğeyi okur ve içeriği bir String nesne olarak döndürür.

Aşırı Yüklemeler

ReadElementContentAsString(String, String)

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği bir String nesne olarak döndürür.

ReadElementContentAsString()

Geçerli öğeyi okur ve içeriği bir String nesne olarak döndürür.

ReadElementContentAsString(String, String)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği bir String nesne olarak döndürür.

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

Parametreler

localName
String

Öğesinin yerel adı.

namespaceURI
String

öğesinin ad alanı URI'si.

Döndürülenler

Nesne olarak String öğe içeriği.

Özel durumlar

XmlReader öğesinde konumlandırılmaz.

-veya-

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Geçerli öğe alt öğeleri içerir.

-veya-

Öğe içeriği bir String nesneye dönüştürülemez.

yöntemi bağımsız değişkenlerle null çağrılır.

Belirtilen yerel ad ve ad alanı URI'si okunan geçerli öğenin adıyla eşleşmiyor.

Örnekler

Aşağıdaki örnek öğesini okur stringValue ve metin içeriğini döndürür (açıklama ve işleme yönergesi yoksayılarak).

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

Örnek, giriş olarak dosyasını kullanır 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>

Açıklamalar

Bu yöntem başlangıç etiketini, öğesinin içeriğini okur ve okuyucuyu bitiş öğesi etiketinin dışına taşır. Varlıkları genişletir ve işleme yönergelerini ve açıklamalarını yoksayar. öğesi yalnızca basit içerik içerebilir. Başka bir ifadeyle, alt öğeleri olamaz.

Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader ve W3C XML Şema Bölüm 2: Veri türleri önerisine bakın.

Şunlara uygulanır

ReadElementContentAsString()

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Geçerli öğeyi okur ve içeriği bir String nesne olarak döndürür.

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

Döndürülenler

Nesne olarak String öğe içeriği.

Özel durumlar

XmlReader öğesinde konumlandırılmaz.

-veya-

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Geçerli öğe alt öğeleri içerir.

-veya-

Öğe içeriği bir String nesneye dönüştürülemez.

yöntemi bağımsız değişkenlerle null çağrılır.

Örnekler

Aşağıdaki örnek öğesini okur stringValue ve metin içeriğini döndürür (açıklama ve işleme yönergesi yoksayılarak).

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

Örnek, giriş olarak dosyasını kullanır 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>

Açıklamalar

Bu yöntem başlangıç etiketini, öğesinin içeriğini okur ve okuyucuyu bitiş öğesi etiketinin dışına taşır. Varlıkları genişletir ve işleme yönergelerini ve açıklamalarını yoksayar. öğesi yalnızca basit içerik içerebilir. Başka bir ifadeyle, alt öğeleri olamaz.

Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader ve W3C XML Şema Bölüm 2: Veri türleri önerisine bakın.

Bu yöntemin zaman uyumsuz sürümü için bkz ReadElementContentAsStringAsync. .

Şunlara uygulanır