XmlWriter.WriteQualifiedName(String, String) Methode

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly's:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Bron:
XmlWriter.cs
Bron:
XmlWriter.cs
Bron:
XmlWriter.cs
Bron:
XmlWriter.cs
Bron:
XmlWriter.cs

Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u de naamruimte-gekwalificeerde naam uit. Met deze methode wordt gezocht naar het voorvoegsel dat binnen het bereik van de opgegeven naamruimte valt.

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)

Parameters

localName
String

De lokale naam die moet worden geschreven.

ns
String

De naamruimte-URI voor de naam.

Uitzonderingen

ArgumentException

localName null is of String.Empty.

localName is geen geldige naam.

InvalidOperationException

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Voorbeelden

In het voorbeeld wordt het volgende element geschreven:

<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

Opmerkingen

Als ns deze wordt toegewezen aan de huidige standaardnaamruimte, wordt er geen voorvoegsel gegenereerd.

Bij het schrijven van kenmerkwaarden genereert deze methode een voorvoegsel als ns dit niet wordt gevonden. Bij het schrijven van elementinhoud wordt er een uitzondering gegenereerd als ns deze niet wordt gevonden.

Note

Als een klasse die is afgeleid van de XmlWriter klasse niet overschrijft, wordt deze methode localName niet gecontroleerd als een geldige W3C XML-naam. In dat geval kan de geldigheid van de tekenreeks worden gecontroleerd voordat IsName u deze methode aanroept.

Zie voor de asynchrone versie van deze methode WriteQualifiedNameAsync.

Van toepassing op