XmlDocument.CreateProcessingInstruction メソッド

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

XmlDocument.CreateProcessingInstruction メソッド

指定した名前とデータを使用して XmlProcessingInstruction を作成します。

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

Visual Basic (宣言)

Public Overridable Function
 CreateProcessingInstruction ( _
    target As String, _
    data As String _
) As XmlProcessingInstruction

Visual Basic (使用法)

Dim instance As XmlDocument
Dim target As String
Dim data As String
Dim returnValue As XmlProcessingInstruction

returnValue = instance.CreateProcessingInstruction(target, data)

C#

public virtual XmlProcessingInstruction CreateProcessingInstruction
 (
    string target,
    string data
)

C++

public:
virtual XmlProcessingInstruction^ CreateProcessingInstruction (
    String^ target, 
    String^ data
)

J#

public XmlProcessingInstruction CreateProcessingInstruction (
    String target, 
    String data
)

JScript

public function CreateProcessingInstruction
 (
    target : String, 
    data : String
) : XmlProcessingInstruction

パラメータ

target

処理命令の名前。

data

処理命令のデータ。

戻り値
新しい XmlProcessingInstruction。

解説

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

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

使用例

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

Visual Basic

Imports System
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    Dim doc as XmlDocument = new
 XmlDocument()

    ' Create a procesing instruction.
    Dim newPI as XmlProcessingInstruction 
    Dim PItext as String
 = "type='text/xsl' href='book.xsl'"
    newPI = doc.CreateProcessingInstruction("xml-stylesheet",
 PItext)

    ' Display the target and data information.
    Console.WriteLine("<?{0} {1}?>", newPI.Target,
 newPI.Data)

    ' Add the processing instruction node to the document.
    doc.AppendChild(newPI)

  end sub
end class

C#

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

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();

    // Create a procesing instruction.
    XmlProcessingInstruction newPI;
    String PItext = "type='text/xsl' href='book.xsl'";
    newPI = doc.CreateProcessingInstruction("xml-stylesheet", PItext);

    // Display the target and data information.
    Console.WriteLine("<?{0} {1}?>", newPI.Target, newPI.Data);

    // Add the processing instruction node to the document.
    doc.AppendChild(newPI);

  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   
   // Create a procesing instruction.
   XmlProcessingInstruction^ newPI;
   String^ PItext = "type='text/xsl' href='book.xsl'";
   newPI = doc->CreateProcessingInstruction( "xml-stylesheet", PItext
 );
   
   // Display the target and data information.
   Console::WriteLine( "<?{0} {1}?>", newPI->Target, newPI->Data
 );
   
   // Add the processing instruction node to the document.
   doc->AppendChild( newPI );
}

J#

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

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlDocument doc = new XmlDocument();

        // Create a procesing instruction.
        XmlProcessingInstruction newPI;
        String pIText = "type='text/xsl' href='book.xsl'";
        newPI = doc.CreateProcessingInstruction("xml-stylesheet", pIText);

        // Display the target and data information.
        Console.WriteLine("<?{0} {1}?>", newPI.get_Target(), newPI.get_Data());

        // Add the processing instruction node to the document.
        doc.AppendChild(newPI);
    } //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 名前空間