XmlWriter.WriteQualifiedName-Methode

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

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Sub WriteQualifiedName ( _
    localName As String, _
    ns As String _
)
'Usage
Dim instance As XmlWriter
Dim localName As String
Dim ns As String

instance.WriteQualifiedName(localName, ns)

public virtual void WriteQualifiedName (
    string localName,
    string ns
)

public:
virtual void WriteQualifiedName (
    String^ localName, 
    String^ ns
)

public void WriteQualifiedName (
    String localName, 
    String ns
)

public function WriteQualifiedName (
    localName : String, 
    ns : String
)

Parameter

• localName
  Der zu schreibende lokale Name.

• ns
  Der Namespace-URI für den Namen.

Ausnahmen

Hinweise

Wenn ns dem aktuellen Standardnamespace zugeordnet wird, wird kein Präfix generiert.

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

Beispiel

Im Beispiel wird das folgende Element geschrieben:

<root xmlns:x="urn:abc">
  <item href="#x:test"/>
</root>

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

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();
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlWriter-Klasse
XmlWriter-Member
System.Xml-Namespace

Weitere Ressourcen

Schreiben von XML mit dem "XmlWriter"