XmlDocument.CreateProcessingInstruction メソッド

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

Public Overridable Function CreateProcessingInstruction( _
   ByVal target As String, _   ByVal data As String _) As XmlProcessingInstruction
[C#]
public virtual XmlProcessingInstruction CreateProcessingInstruction(stringtarget,stringdata);
[C++]
public: virtual 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 の各ノード内だけで使用できます。

使用例

[Visual Basic, C#, C++] ProcessingInstruction ノードを作成し、ドキュメントに追加する例を次に示します。

 
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 <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
    XmlDocument* doc = new XmlDocument();

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

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

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

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

XmlDocument クラス | XmlDocument メンバ | System.Xml 名前空間