XmlTextReader.WhitespaceHandling プロパティ

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

ソース:

XmlTextReader.cs

空白の処理方法を指定する値を取得または設定します。

C#

public System.Xml.WhitespaceHandling WhitespaceHandling { get; set; }

プロパティ値

WhitespaceHandling

WhitespaceHandling 値のいずれか 1 つ。 既定値は WhitespaceHandling.All で、Whitespace と SignificantWhitespace ノードを返します。

例外

ArgumentOutOfRangeException

無効な値を指定しています。

InvalidOperationException

リーダーが閉じているとき (ReadState が ReadState.Closed のとき) にこのプロパティを設定します。

例

次の例では、XML フラグメントを読み取ります。

C#

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

public class Sample
{
  public static void Main(){

    //Create the XML fragment to be parsed.
    string xmlFrag ="<book> " +
                    "  <title>Pride And Prejudice</title>" +
                    "  <genre>novel</genre>" +
                    "</book>";

    //Create the XmlNamespaceManager.
    NameTable nt = new NameTable();
    XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);

    //Create the XmlParserContext.
    XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.Default);

    Console.WriteLine("Read the XML and ignore all white space...");
    ReadXML(context, xmlFrag, WhitespaceHandling.None);

    Console.WriteLine("\r\nRead the XML including white space nodes...");
    ReadXML(context, xmlFrag, WhitespaceHandling.All);
  }

  public static void ReadXML(XmlParserContext context, string xmlFrag, WhitespaceHandling ws){

    //Create the reader and specify the WhitespaceHandling setting.
    XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context);
    reader.WhitespaceHandling = ws;

      //Parse the XML and display each of the nodes.
      while (reader.Read())
      {
         switch (reader.NodeType)
         {
           case XmlNodeType.Element:
             Console.WriteLine("{0}: <{1}>", reader.NodeType, reader.Name);
             break;
           case XmlNodeType.Text:
             Console.WriteLine("{0}: {1}", reader.NodeType, reader.Value);
             break;
           case XmlNodeType.EndElement:
             Console.WriteLine("{0}: </{1}>", reader.NodeType, reader.Name);
             break;
           case XmlNodeType.Whitespace:
             Console.WriteLine("{0}:", reader.NodeType);
             break;
           case XmlNodeType.SignificantWhitespace:
             Console.WriteLine("{0}:", reader.NodeType);
             break;
         }
      }

    //Close the reader.
    reader.Close();
  }
} // End class

注釈

注意

.NET Framework 2.0 以降では、 メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

このプロパティはいつでも変更でき、次の読み取り操作で有効になります。

には XmlTextReader DTD 情報がないため、 SignificantWhitespace ノードはスコープ内 xml:space='preserve' でのみ返されます。

適用対象

こちらもご覧ください

• XmlReader