XmlReader.Value Özellik

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümün metin değerini alır.

C#

public abstract string Value { get; }

Özellik Değeri

String

Döndürülen değer düğümün NodeType değerine bağlıdır. Aşağıdaki tabloda, döndürülecek bir değere sahip düğüm türleri listelenmiştir. Diğer tüm düğüm türleri döndürür String.Empty.

Düğüm türü	Değer
Attribute	özniteliğinin değeri.
CDATA	CDATA bölümünün içeriği.
Comment	Açıklamanın içeriği.
DocumentType	İç alt küme.
ProcessingInstruction	Hedef hariç tüm içerik.
SignificantWhitespace	Karma içerik modelinde işaretleme arasındaki boşluk.
Text	Metin düğümünün içeriği.
Whitespace	İşaretlemeyi arasındaki boşluk.
XmlDeclaration	Bildirimin içeriği.

Özel durumlar

InvalidOperationException

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

Örnekler

Aşağıdaki örnek bir XML dosyasını okur ve düğümlerin her birini görüntüler.

C#

XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
XmlReader reader = XmlReader.Create("items.xml", settings);

reader.MoveToContent();
  // Parse the file and display each of the nodes.
  while (reader.Read()) {
    switch (reader.NodeType) {
      case XmlNodeType.Element:
          Console.Write("<{0}>", reader.Name);
          break;
      case XmlNodeType.Text:
          Console.Write(reader.Value);
          break;
       case XmlNodeType.CDATA:
           Console.Write("<![CDATA[{0}]]>", reader.Value);
           break;
       case XmlNodeType.ProcessingInstruction:
           Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
           break;
       case XmlNodeType.Comment:
           Console.Write("<!--{0}-->", reader.Value);
           break;
       case XmlNodeType.XmlDeclaration:
           Console.Write("<?xml version='1.0'?>");
           break;
       case XmlNodeType.Document:
           break;
       case XmlNodeType.DocumentType:
           Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
           break;
       case XmlNodeType.EntityReference:
           Console.Write(reader.Name);
           break;
       case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
   }
}

Örnek, items.xml dosyasını kullanır.

XML

<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
  <Item>Test with an entity: &number;</Item>
  <Item>Test with a child element <more/> stuff</Item>
  <Item>Test with a CDATA section <![CDATA[<456>]]> def</Item>
  <Item>Test with a char entity: A</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Açıklamalar

Bu özelliğin zaman uyumsuz sürümü için yöntemine GetValueAsync bakın.

Şunlara uygulanır