XmlDocument.CreateSignificantWhitespace メソッド

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

XmlDocument.CreateSignificantWhitespace メソッド

XmlSignificantWhitespace ノードを作成します。

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

Visual Basic (宣言)

Public Overridable Function
 CreateSignificantWhitespace ( _
    text As String _
) As XmlSignificantWhitespace

Visual Basic (使用法)

Dim instance As XmlDocument
Dim text As String
Dim returnValue As XmlSignificantWhitespace

returnValue = instance.CreateSignificantWhitespace(text)

C#

public virtual XmlSignificantWhitespace CreateSignificantWhitespace
 (
    string text
)

C++

public:
virtual XmlSignificantWhitespace^ CreateSignificantWhitespace (
    String^ text
)

J#

public XmlSignificantWhitespace CreateSignificantWhitespace (
    String text
)

JScript

public function CreateSignificantWhitespace
 (
    text : String
) : XmlSignificantWhitespace

パラメータ

text

文字列には、、
、
、および 	 の文字だけを含める必要があります。

戻り値
新しい XmlSignificantWhitespace ノード。

解説

このメソッドは、DOM (Document Object Model) に対する Microsoft 拡張機能です。ドキュメントを手動で書式指定するときに使用します。

このメソッドは、ドキュメントのコンテキスト内で新しいオブジェクトを作成しますが、自動的には新しいオブジェクトをドキュメント ツリーに追加しません。新しいオブジェクトを追加するには、ノード挿入メソッドのいずれか 1 つを明示的に呼び出す必要があります。

使用例

ドキュメントに有意な空白を追加する例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.Xml
Imports Microsoft.VisualBasic

Public Class Sample
    
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<author xml:space='preserve'>"
 & _
                    "<first-name>Eva</first-name>"
 & _
                    "<last-name>Corets</last-name>"
 & _
                    "</author>")
            
        Console.WriteLine("InnerText before...")
        Console.WriteLine(doc.DocumentElement.InnerText)
            
        ' Add white space.    
        Dim currNode as XmlNode = doc.DocumentElement
        Dim sigws As XmlSignificantWhitespace
 = doc.CreateSignificantWhitespace(ControlChars.Tab)
        currNode.InsertAfter(sigws, currNode.FirstChild)
            
        Console.WriteLine()
        Console.WriteLine("InnerText after...")
        Console.WriteLine(doc.DocumentElement.InnerText)
        
    End Sub 
End Class 'Sample

C#

using System;
using System.Xml;

public class Sample {
  
  public static void Main()
 {

      XmlDocument doc = new XmlDocument();
      doc.LoadXml("<author xml:space='preserve'>" +
                  "<first-name>Eva</first-name>"+
                  "<last-name>Corets</last-name>" + 
                  "</author>"); 
        
      Console.WriteLine("InnerText before...");
      Console.WriteLine(doc.DocumentElement.InnerText);

      // Add white space.     
      XmlNode currNode = doc.DocumentElement;
      XmlSignificantWhitespace sigws = doc.CreateSignificantWhitespace("\t");
      currNode.InsertAfter(sigws, currNode.FirstChild);

      Console.WriteLine();
      Console.WriteLine("InnerText after...");
      Console.WriteLine(doc.DocumentElement.InnerText);

  } 
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<author xml:space='preserve'><first-name>Eva</first-name><last-name>Corets</last-name></author>"
 );
   Console::WriteLine( "InnerText before..." );
   Console::WriteLine( doc->DocumentElement->InnerText );
   
   // Add white space.     
   XmlNode^ currNode = doc->DocumentElement;
   XmlSignificantWhitespace^ sigws = doc->CreateSignificantWhitespace( "\t"
 );
   currNode->InsertAfter( sigws, currNode->FirstChild );
   Console::WriteLine();
   Console::WriteLine( "InnerText after..." );
   Console::WriteLine( doc->DocumentElement->InnerText );
}

J#

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

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<author xml:space='preserve'>"
                    + "<first-name>Eva</first-name>"
                    + "<last-name>Corets</last-name>"
                    + "</author>");

        Console.WriteLine("InnerText before...");
        Console.WriteLine(doc.get_DocumentElement().get_InnerText());

        // Add white space.     
        XmlNode currNode = doc.get_DocumentElement();
        XmlSignificantWhitespace sigWs = doc.CreateSignificantWhitespace("\t");
        currNode.InsertAfter(sigWs, currNode.get_FirstChild());

        Console.WriteLine();
        Console.WriteLine("InnerText after...");
        Console.WriteLine(doc.get_DocumentElement().get_InnerText());
    } //main
} //Sample

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlDocument クラス
XmlDocument メンバ
System.Xml 名前空間