XmlDocument.CreateCDataSection メソッドとは何？わかりやすく解説 Weblio辞書

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

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

XmlDocument.CreateCDataSection メソッド

指定されたデータを格納している XmlCDataSection を作成します。

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

Visual Basic (宣言)

Public Overridable Function
 CreateCDataSection ( _
    data As String _
) As XmlCDataSection

Visual Basic (使用法)

Dim instance As XmlDocument
Dim data As String
Dim returnValue As XmlCDataSection

returnValue = instance.CreateCDataSection(data)

public virtual XmlCDataSection CreateCDataSection (
    string data
)

C++

public:
virtual XmlCDataSection^ CreateCDataSection (
    String^ data
)

public XmlCDataSection CreateCDataSection (
    String data
)

JScript

public function CreateCDataSection (
    data : String
) : XmlCDataSection

パラメータ

data: 新しい XmlCDataSection の内容。

戻り値
新しい XmlCDataSection。

解説

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

W3C 勧告『Extensible Markup Language (XML) 1.0』(www.w3.org/TR/1998/REC-xml-19980210) に従って、EntityReference ノードが Attribute ノードの子でない場合、CDataSection ノードは、Element ノード内および EntityReference ノードで使用できます。

使用例

CDATA ノードを作成し、ドキュメントに追加する例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>"
  & _
                    "<title>Pride And Prejudice</title>"
  & _
                    "</book>")
        
        'Create a CData section.
        Dim CData As XmlCDataSection
        CData = doc.CreateCDataSection("All Jane Austen novels
 25% off starting 3/23!")
        
        'Add the new node to the document.
        Dim root As XmlElement = doc.DocumentElement
        root.AppendChild(CData)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub 'Main
End Class 'Sample

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

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create a CData section.
    XmlCDataSection CData;
    CData = doc.CreateCDataSection("All Jane Austen novels 25% off starting
 3/23!");    

    //Add the new node to the document.
    XmlElement root = doc.DocumentElement;
    root.AppendChild(CData);  
        
    Console.WriteLine("Display the modified XML...");        
    doc.Save(Console.Out);
  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'><title>Pride
 And Prejudice</title></book>" );
   
   //Create a CData section.
   XmlCDataSection^ CData;
   CData = doc->CreateCDataSection( "All Jane Austen novels 25% off starting
 3/23!" );
   
   //Add the new node to the document.
   XmlElement^ root = doc->DocumentElement;
   root->AppendChild( CData );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

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

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml(("<book genre='novel' ISBN='1-861001-57-5'>"
                    + "<title>Pride And Prejudice</title>"
                    + "</book>"));

        //Create a CData section.
        XmlCDataSection cData;
        cData = doc.CreateCDataSection("All Jane Austen novels 25% off"
            + " starting 3/23!");

        //Add the new node to the document.
        XmlElement root = doc.get_DocumentElement();
        root.AppendChild(cData);

        Console.WriteLine("Display the modified XML...");
        doc.Save(Console.get_Out());
    } //main
} //Sample