Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlTextWriter.WriteQualifiedName méthode (String, String)

 

Date de publication : novembre 2016

Écrit le nom qualifié de l'espace de noms. Cette méthode recherche le préfixe situé dans la portée de l'espace de noms spécifié.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public override void WriteQualifiedName(
	string localName,
	string ns
)

Paramètres

localName
Type: System.String

Nom local à écrire.

ns
Type: System.String

L’espace de noms URI à associer au nom.

Exception Condition
ArgumentException

localName est soit null ou String.Empty.

localName n’est pas un nom valide conformément à la spécification des espaces de noms W3C.

System_CAPS_noteRemarque

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter instances à l’aide de la XmlWriter.Create méthode et la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

Par exemple, le code Microsoft Visual c# suivant :

writer.Formatting = Formatting.Indented;
writer.WriteStartElement("root");
 writer.WriteAttributeString("xmlns","x",null,"urn:abc");
 writer.WriteStartElement("item");
 writer.WriteStartAttribute("href",null);
 writer.WriteString("#");
 writer.WriteQualifiedName("test","urn:abc");
 writer.WriteEndAttribute();
 writer.WriteEndElement();
 writer.WriteEndElement();
 writer.Close();

Génère la sortie suivante :

<root xmlns:x="urn:abc">
 <item href="#x:test"/>
 </root>

Si ns est mappé à la valeur par défaut espace de noms actuel, aucun préfixe n’est généré.

Lorsque vous écrivez des valeurs d’attribut, cette méthode génère un préfixe si ns est introuvable. Lorsque vous écrivez le contenu de l’élément, elle lève une exception si ns est introuvable.

Si ce writer prend en charge les espaces de noms (Namespaces a la valeur true), cette méthode vérifie également que le nom est valide d’après les espaces de noms W3C dans la recommandation XML (http://www.w3.org/TR/REC-xml-names).

L’exemple suivant écrit une partie d’un schéma XSD.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  private const string filename = "sampledata.xml";

  public static void Main()
  {
     XmlTextWriter writer = null;

     writer = new XmlTextWriter (filename, null);
     // Use indenting for readability.
     writer.Formatting = Formatting.Indented;

     // Write the root element.
     writer.WriteStartElement("schema");

     // Write the namespace declarations.
     writer.WriteAttributeString("xmlns", null,"http://www.w3.org/2001/XMLSchema");
     writer.WriteAttributeString("xmlns","po",null,"http://contoso.com/po");

     writer.WriteStartElement("element");

     writer.WriteAttributeString("name", "purchaseOrder");

     // Write the type attribute.
     writer.WriteStartAttribute(null,"type", null);
     writer.WriteQualifiedName("PurchaseOrder", "http://contoso.com/po");
     writer.WriteEndAttribute();

     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();  

     // Read the file back in and parse to ensure well formed XML.
     XmlDocument doc = new XmlDocument();
     // Preserve white space for readability.
     doc.PreserveWhitespace = true;
     // Load the file.
     doc.Load(filename);

     // Write the XML content to the console.
     Console.Write(doc.InnerXml);

  }

}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: