Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

XmlWriter.WriteQualifiedName, méthode

En cas de substitution dans une classe dérivée, é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 virtual void WriteQualifiedName(
	string localName,
	string ns
)

Paramètres

localName
Type : System.String
Nom local à écrire.
ns
Type : System.String
URI d'espace de noms de ce nom.

ExceptionCondition
ArgumentException

localName est null ou String.Empty.

localName n'est pas un nom valide.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d'une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message indiquant qu'une opération asynchrone est déjà en cours.

Si ns correspond à l'espace de noms par défaut actuel, aucun préfixe n'est généré.

Lors de l'écriture de valeurs d'attributs, cette méthode génère un préfixe si ns est introuvable. Lors de l'écriture d'un contenu d'élément, elle lève une exception si ns est introuvable.

RemarqueRemarque

Si une classe dérivée du XmlWriter ne substitue pas cette méthode, localName n'est pas vérifié pour être un nom de W3C XML valide. Dans ce cas, avant d'appeler cette méthode, la validité de la chaîne peut être vérifiée par méthode IsName.

Pour la version asynchrone de la méthode, consultez l'WriteQualifiedNameAsync.

L'exemple écrit l'élément suivant :

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

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
using (XmlWriter writer = XmlWriter.Create(Console.Out, settings))
{
    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();
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft