XmlWriter.WriteQualifiedName(String, String) Méthode

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs
Source:
XmlWriter.cs

En cas de substitution dans une classe dérivée, écrit le nom qualifié d’espace de noms. Cette méthode recherche le préfixe qui est dans l’étendue de l’espace de noms donné.

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 du nom.

Exceptions

ArgumentException

localName est ou nullString.Empty.

localName n’est pas un nom valide.

InvalidOperationException

Une XmlWriter méthode 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 « 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 la carte 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 est introuvable. Lors de l’écriture du contenu de l’élément, elle lève une exception si ns elle est introuvable.

Note

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 à