Export (0) Print
Expand All

XmlDocument.CreateProcessingInstruction Method

Creates an XmlProcessingInstruction with the specified name and data.

[Visual Basic]
Public Overridable Function CreateProcessingInstruction( _
   ByVal target As String, _
   ByVal data As String _
) As XmlProcessingInstruction
[C#]
public virtual XmlProcessingInstruction CreateProcessingInstruction(
 string target,
 string data
);
[C++]
public: virtual XmlProcessingInstruction* CreateProcessingInstruction(
 String* target,
 String* data
);
[JScript]
public function CreateProcessingInstruction(
   target : String,
 data : String
) : XmlProcessingInstruction;

Parameters

target
The name of the processing instruction.
data
The data for the processing instruction.

Return Value

The new XmlProcessingInstruction.

Remarks

Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. To add the new object, you must explicitly call one of the node insert methods.According to the W3C Extensible Markup Language (XML) 1.0 recommendation (www.w3.org/TR/1998/REC-xml-19980210), ProcessingInstruction nodes are only allowed within Document, Element, and EntityReference nodes, when the EntityReference node is not a child of an Attribute node.

Example

[Visual Basic, C#, C++] The following example creates a ProcessingInstruction node and adds it to the document.

[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 <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] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

XmlDocument Class | XmlDocument Members | System.Xml Namespace

Show:
© 2014 Microsoft