XmlDocument.PreserveWhitespace プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlDocument.PreserveWhitespace プロパティ

要素のコンテンツにある空白を保存するかどうかを示す値を取得または設定します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property PreserveWhitespace As
 Boolean

Visual Basic (使用法)

Dim instance As XmlDocument
Dim value As Boolean

value = instance.PreserveWhitespace

instance.PreserveWhitespace = value

public bool PreserveWhitespace { get;
 set; }

C++

public:
property bool PreserveWhitespace {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_PreserveWhitespace ()

/** @property */
public void set_PreserveWhitespace (boolean
 value)

JScript

public function get PreserveWhitespace
 () : boolean

public function set PreserveWhitespace
 (value : boolean)

プロパティ値
空白である場合は true。それ以外の場合は false。既定値は false です。

解説

このプロパティは、読み込みおよび保存プロセス中の空白の処理方法を決定します。

Load または LoadXml が呼び出される前に PreserveWhitespace が true の場合、空白ノードは保存されます。このプロパティが false の場合、有意な空白は保存されますが、空白は保存されません。

Save が呼び出される前に PreserveWhitespace が true の場合、ドキュメント内の空白は出力で保存されます。このプロパティが false の場合、XmlDocument は出力に自動的にインデントを設定します。

このメソッドは、DOM (Document Object Model) に対する Microsoft 拡張機能です。

使用例

ファイルから空白を取り除く方法を次の例に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    'Load XML data which includes white space, but ignore
    'any white space in the file.
    Dim doc as XmlDocument = new
 XmlDocument()
    doc.PreserveWhitespace = false
    doc.Load("book.xml")

    'Save the document as is (no white space).
    Console.WriteLine("Display the modified XML...")
    doc.PreserveWhitespace = true
    doc.Save(Console.Out)

  end sub
end class

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

public class Sample
{
  public static void Main()
  {
    //Load XML data which includes white space, but ignore
    //any white space in the file.
    XmlDocument doc = new XmlDocument();
    doc.PreserveWhitespace = false;
    doc.Load("book.xml");

    //Save the document as is (no white space).
    Console.WriteLine("Display the modified XML...");
    doc.PreserveWhitespace = true;
    doc.Save(Console.Out);

   }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Load XML data which includes white space, but ignore
   //any white space in the file.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->PreserveWhitespace = false;
   doc->Load( "book.xml" );
   
   //Save the document as is (no white space).
   Console::WriteLine( "Display the modified XML..." );
   doc->PreserveWhitespace = true;
   doc->Save( Console::Out );
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        // Load XML data which includes white space, but ignore
        // any white space in the file.
        XmlDocument doc = new XmlDocument();
        doc.set_PreserveWhitespace(false);
        doc.Load("book.xml");

        // Save the document as is (no white space).
        Console.WriteLine("Display the modified XML...");
        doc.set_PreserveWhitespace(true);
        doc.Save(Console.get_Out());
    } //main 
} //Sample

この例では、入力として、book.xml というファイルを使用しています。

<!--sample XML fragment-->
<book genre='novel' ISBN='1-861003-78'
 misc='sale-item'>
  <title>The Handmaid's
 Tale</title>
  <price>14.95</price>
</book>