XmlDocument.CreateProcessingInstruction(String, String) Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.dll

Crée un XmlProcessingInstruction avec le nom et les données spécifiés.

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

Paramètres

target

String

Nom de l’instruction de traitement.

data

String

Données pour l’instruction de traitement.

Retours

XmlProcessingInstruction

XmlProcessingInstructionNouveau .

Exemples

L’exemple suivant crée un nœud ProcessingInstruction et l’ajoute au 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

Remarques

Bien que cette méthode crée le nouvel objet dans le contexte du document, il n’ajoute pas automatiquement le nouvel objet à l’arborescence de documents. Pour ajouter le nouvel objet, vous devez appeler explicitement l’une des méthodes d’insertion de nœud.

Selon la recommandation W3C Extensible Markup Language (XML) 1.0, les nœuds ProcessingInstruction ne sont autorisés que dans les nœuds Document, Element et EntityReference, lorsque le nœud EntityReference n’est pas un enfant d’un nœud Attribute.