XmlWriter.WriteQualifiedName(String, String) Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Schreibt beim Überschreiben in einer abgeleiteten Klasse den durch den Namespace angegebenen Namen. Diese Methode sucht das Präfix im Gültigkeitsbereich des Namespaces.

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)

Parameter

localName

String

Der zu schreibende lokale Name.

ns

String

Der Namespace-URI für den Namen.

Ausnahmen

ArgumentException

localName ist entweder null oder String.Empty.

localName ist kein gültiger Name.

InvalidOperationException

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Im Beispiel wird das folgende Element geschrieben:

<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

Hinweise

Wenn ns der aktuelle Standardnamespace zugeordnet wird, wird kein Präfix generiert.

Beim Schreiben von Attributwerten generiert diese Methode ein Präfix, falls ns nicht gefunden wird. Beim Schreiben von Elementinhalten wird eine Ausnahme ausgelöst, wenn ns sie nicht gefunden wird.

Hinweis

Wenn eine von der XmlWriter Methode abgeleitete Klasse nicht außer Kraft localName setzt, wird nicht überprüft, ob es sich um einen gültigen W3C-XML-Namen handelt. In diesem Fall kann vor dem Aufrufen dieser Methode die Gültigkeit der Zeichenfolge nach IsName Methode überprüft werden.

Die asynchrone Version dieser Methode finden Sie unter WriteQualifiedNameAsync.