XmlReader.ReadElementContentAsString Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

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

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

String

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

Özel durumlar

InvalidOperationException

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.

XmlException

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

-veya-

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

ArgumentNullException

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

ArgumentException

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.

ReadElementContentAsString()

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

String

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

Özel durumlar

InvalidOperationException

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.

XmlException

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

-veya-

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

ArgumentNullException

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