XmlReader.Value プロパティ

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

ソース:

XmlReader.cs

派生クラスでオーバーライドされると、現在のノードのテキスト値を取得します。

C#

public abstract string Value { get; }

プロパティ値

String

返される値は、ノードの NodeType によって異なります。 返す値を持つノード型の一覧を次の表に示します。 これ以外のノード型はすべて String.Empty を返します。

ノード型	値
Attribute	属性の値。
CDATA	CDATA セクションの内容。
Comment	コメントの内容。
DocumentType	内部サブセット。
ProcessingInstruction	ターゲットを除く全内容。
SignificantWhitespace	混合コンテンツ モデル内のマークアップ間の空白。
Text	テキスト ノードの内容。
Whitespace	マークアップ間の空白。
XmlDeclaration	宣言の内容。

例外

InvalidOperationException

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

例

次の例では、XML ファイルを読み取り、各ノードを表示します。

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;
   }
}

このサンプルでは、 ファイルを使用します items.xml 。

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>

注釈

このプロパティの非同期バージョンについては、 メソッドを GetValueAsync 参照してください。

適用対象