XmlDocument.CreateProcessingInstruction(String, String) Methode

Definitie

Naamruimte:

System.Xml

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Bron:

XmlDocument.cs

Hiermee maakt u een XmlProcessingInstruction met de opgegeven naam en gegevens.

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

public virtual System.Xml.XmlProcessingInstruction CreateProcessingInstruction(string target, string? data);

abstract member CreateProcessingInstruction : string * string -> System.Xml.XmlProcessingInstruction
override this.CreateProcessingInstruction : string * string -> System.Xml.XmlProcessingInstruction

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

Parameters

target

String

De naam van de verwerkingsinstructie.

data

String

De gegevens voor de verwerkingsinstructie.

Retouren

XmlProcessingInstruction

Het nieuwe XmlProcessingInstruction.

Voorbeelden

In het volgende voorbeeld wordt een ProcessingInstruction-knooppunt gemaakt en toegevoegd aan het document.

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

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

Opmerkingen

Hoewel met deze methode het nieuwe object wordt gemaakt in de context van het document, wordt het nieuwe object niet automatisch toegevoegd aan de documentstructuur. Als u het nieuwe object wilt toevoegen, moet u expliciet een van de methoden voor het invoegen van knooppunten aanroepen.

Volgens de aanbeveling W3C Extensible Markup Language (XML) 1.0 zijn ProcessingInstruction-knooppunten alleen toegestaan binnen de knooppunten Document, Element en EntityReference, wanneer het knooppunt EntityReference geen onderliggend element van een kenmerkknooppunt is.