Partager via


XmlWriter.WriteQualifiedName(String, String) Méthode

Définition

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é.

public:
 virtual void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public:
 abstract void WriteQualifiedName(System::String ^ localName, System::String ^ ns);
public virtual void WriteQualifiedName (string localName, string ns);
public virtual void WriteQualifiedName (string localName, string? ns);
public abstract void WriteQualifiedName (string localName, string ns);
abstract member WriteQualifiedName : string * string -> unit
override this.WriteQualifiedName : string * string -> unit
abstract member WriteQualifiedName : string * string -> unit
Public Overridable Sub WriteQualifiedName (localName As String, ns As String)
Public MustOverride Sub WriteQualifiedName (localName As String, ns As String)

Paramètres

localName
String

Nom local à écrire.

ns
String

URI d'espace de noms de ce nom.

Exceptions

localName a la valeur null ou String.Empty.

localName n'est pas un nom valide.

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

Exemples

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();
}
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.OmitXmlDeclaration = True
Using writer As XmlWriter = XmlWriter.Create(Console.Out, settings)
  writer.WriteStartElement("root")
  writer.WriteAttributeString("xmlns", "x", Nothing, "urn:abc")
  writer.WriteStartElement("item")
  writer.WriteStartAttribute("href", Nothing)
  writer.WriteString("#")
  writer.WriteQualifiedName("test", "urn:abc")
  writer.WriteEndAttribute()
  writer.WriteEndElement()
  writer.WriteEndElement()
End Using

Remarques

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

Lors de l’écriture de valeurs d’attribut, cette méthode génère un préfixe s’il ns n’est pas trouvé. Lors de l’écriture du contenu de l’élément, il lève une exception si ns elle n’est pas trouvée.

Notes

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

Pour obtenir la version asynchrone de cette méthode, consultez WriteQualifiedNameAsync.

S’applique à