XmlWriter.WriteQualifiedName(String, String) Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

ArgumentException

localName a la valeur 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, 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.