XmlTextReader.ReadString Yöntem

Tanım

Bir öğenin veya metin düğümünün içeriğini dize olarak okur.

public override string ReadString ();

Döndürülenler

Öğenin veya metin düğümünün içeriği. Okuyucu bir öğe veya metin düğümü dışında bir şeye konumlandırılmışsa veya geçerli bağlamda döndürülecek başka metin içeriği yoksa, bu boş bir dize olabilir.

Note: Metin düğümü bir öğe veya öznitelik metin düğümü olabilir.

Özel durumlar

XML ayrıştırılırken bir hata oluştu.

Geçersiz bir işlem denendi.

Örnekler

Aşağıdaki örnekte her öğenin metin içeriği görüntülenir.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlTextReader reader = null;

    try
    {
       //Load the reader with the XML file.
       reader = new XmlTextReader("elems.xml");

       //Parse the XML and display the text content of each of the elements.
       while (reader.Read()){
         if (reader.IsStartElement()){
           if (reader.IsEmptyElement)
                    {
                        Console.WriteLine("<{0}/>", reader.Name);
                    }
                    else
                    {
               Console.Write("<{0}> ", reader.Name);
               reader.Read(); //Read the start tag.
               if (reader.IsStartElement())  //Handle nested elements.
                 Console.Write("\r\n<{0}>", reader.Name);
               Console.WriteLine(reader.ReadString());  //Read the text content of the element.
           }
         }
       }
     }

     finally
     {
        if (reader != null)
          reader.Close();
      }
  }
} // End class

Örnekte giriş elems.xmlolarak dosyası kullanılır.


<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

Açıklamalar

Not

.NET Framework 2.0'dan başlayarak, yeni işlevlerden yararlanmak için yöntemini kullanarak XmlReader.Create örnekler oluşturmanızı XmlReader öneririz.

Bir öğeye konumlandırıldıysa, ReadString tüm metinleri, önemli boşluk, boşluk ve CData bölüm düğümü türlerini birleştirir ve birleştirilmiş verileri öğe içeriği olarak döndürür. Açıklamalar ve işleme yönergeleri de dahil olmak üzere herhangi bir işaretlemeyle karşılaşıldığında durdurulur. Bu, karma içerik modelinde veya öğe bitiş etiketi okunduğunda oluşabilir.

Bir metin düğümünde konumlandırıldıysa, ReadString metin düğümünden öğe bitiş etiketine aynı birleştirmeyi gerçekleştirir. Okuyucu bir öznitelik metin düğümünde konumlandırıldıysa, ReadString okuyucu öğe başlangıç etiketinde konumlandırılmış gibi aynı işlevlere sahiptir. Tüm birleştirilmiş öğe metin düğümlerini döndürür.

Şunlara uygulanır

Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Ayrıca bkz.