XmlDocument.CreateProcessingInstruction-Methode

Erstellt eine XmlProcessingInstruction mit dem angegebenen Namen und den angegebenen Daten.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Function CreateProcessingInstruction ( _
    target As String, _
    data As String _
) As XmlProcessingInstruction
'Usage
Dim instance As XmlDocument
Dim target As String
Dim data As String
Dim returnValue As XmlProcessingInstruction

returnValue = instance.CreateProcessingInstruction(target, data)

public virtual XmlProcessingInstruction CreateProcessingInstruction (
    string target,
    string data
)

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

public XmlProcessingInstruction CreateProcessingInstruction (
    String target, 
    String data
)

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

Parameter

• target
  Der Name der Verarbeitungsanweisung.

• data
  Die Daten für die Verarbeitungsanweisung.

Rückgabewert

Die neue XmlProcessingInstruction.

Hinweise

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, wird es nicht automatisch der Dokumentstruktur hinzugefügt. Rufen Sie eine der Methoden zum Einfügen von Knoten explizit auf, um das neue Objekt hinzuzufügen.

Entsprechend der W3C-Empfehlung Extensible Markup Language (XML) 1.0 (www.w3.org/TR/1998/REC-xml-19980210, nur auf Englisch verfügbar) sind ProcessingInstruction-Knoten nur in Document-, Element- und EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attribute-Knotens ist.

Beispiel

Im folgenden Beispiel wird ein ProcessingInstruction-Knoten erstellt und dem Dokument hinzugefügt.

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

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);

  }
}

#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 );
}

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

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlDocument-Klasse
XmlDocument-Member
System.Xml-Namespace