XmlWriter.WriteQualifiedName(String, String) Methode

Definition

Namespace:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der namespacequalifizierte Name ausgeschrieben. Diese Methode sucht nach dem Präfix, das sich im Bereich für den angegebenen Namespace befindet.

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 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 InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 sie dem aktuellen Standardnamespace zugeordnet ist, wird kein Präfix generiert.

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

Note

Wenn eine von der XmlWriter Methode abgeleitete Klasse nicht überschreibt, wird diese Methode localName nicht als gültiger W3C-XML-Name überprüft. In diesem Fall kann vor dem Aufrufen dieser Methode die Gültigkeit der Zeichenfolge anhand der IsName Methode überprüft werden.

Die asynchrone Version dieser Methode finden Sie unter WriteQualifiedNameAsync.

Gilt für: