XmlTextWriter.WriteQualifiedName(String, String) Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlTextWriter.cs

Schreibt den namespacequalifizierten Namen aus. Diese Methode sucht nach dem Präfix, das sich im Bereich für den angegebenen Namespace befindet.

public:
 override void WriteQualifiedName(System::String ^ localName, System::String ^ ns);

public override void WriteQualifiedName(string localName, string? ns);

override this.WriteQualifiedName : string * string -> unit

Public Overrides Sub WriteQualifiedName (localName As String, ns As String)

Parameter

localName

String

Der zu schreibende lokale Name.

ns

String

Der Namespace-URI, der dem Namen zugeordnet werden soll.

Ausnahmen

ArgumentException

localName ist entweder null oder String.Empty.

localName ist kein gültiger Name gemäß der W3C-Namespaces-Spezifikation.

Beispiele

Im folgenden Beispiel wird ein Teil eines XSD-Schemas geschrieben.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  private const string filename = "sampledata.xml";

  public static void Main()
  {
     XmlTextWriter writer = null;

     writer = new XmlTextWriter (filename, null);
     // Use indenting for readability.
     writer.Formatting = Formatting.Indented;

     // Write the root element.
     writer.WriteStartElement("schema");

     // Write the namespace declarations.
     writer.WriteAttributeString("xmlns", null,"http://www.w3.org/2001/XMLSchema");
     writer.WriteAttributeString("xmlns","po",null,"http://contoso.com/po");

     writer.WriteStartElement("element");

     writer.WriteAttributeString("name", "purchaseOrder");

     // Write the type attribute.
     writer.WriteStartAttribute(null,"type", null);
     writer.WriteQualifiedName("PurchaseOrder", "http://contoso.com/po");
     writer.WriteEndAttribute();

     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();

     // Read the file back in and parse to ensure well formed XML.
     XmlDocument doc = new XmlDocument();
     // Preserve white space for readability.
     doc.PreserveWhitespace = true;
     // Load the file.
     doc.Load(filename);

     // Write the XML content to the console.
     Console.Write(doc.InnerXml);
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared filename As String = "sampledata.xml"
    Public Shared Sub Main()
        Dim writer As XmlTextWriter = Nothing
        
        writer = New XmlTextWriter(filename, Nothing)
        ' Use indenting for readability.
        writer.Formatting = Formatting.Indented
        
        ' Write the root element.
        writer.WriteStartElement("schema")
        
        ' Write the namespace declarations.
        writer.WriteAttributeString("xmlns", Nothing, "http://www.w3.org/2001/XMLSchema")
        writer.WriteAttributeString("xmlns", "po", Nothing, "http://contoso.com/po")
        
        writer.WriteStartElement("element")
        
        writer.WriteAttributeString("name", "purchaseOrder")
        
        ' Write the type attribute.
        writer.WriteStartAttribute(Nothing, "type", Nothing)
        writer.WriteQualifiedName("PurchaseOrder", "http://contoso.com/po")
        writer.WriteEndAttribute()
        
        writer.WriteEndElement()
        
        ' Write the close tag for the root element.
        writer.WriteEndElement()
        
        ' Write the XML to file and close the writer.
        writer.Flush()
        writer.Close()
        
        ' Read the file back in and parse to ensure well formed XML.
        Dim doc As New XmlDocument()
        ' Preserve white space for readability.
        doc.PreserveWhitespace = True
        ' Load the file.
        doc.Load(filename)
        
        ' Write the XML content to the console.
        Console.Write(doc.InnerXml)
    End Sub
End Class

Hinweise

Hinweis

Wir empfehlen Ihnen, XmlWriter Instanzen mithilfe der XmlWriter.Create Methode und der XmlWriterSettings Klasse zu erstellen, um von neuen Funktionen zu profitieren.

Der folgende Microsoft Visual C#-Code:

writer.Formatting = Formatting.Indented;
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();
 writer.Close();

Generiert folgende Ausgabe:

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

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.

Wenn dieser Writer Namespaces unterstützt (Namespaces ist auf ) festgelegt true), überprüft diese Methode auch, ob der Name gemäß der W3C-Namespaces in XML-Empfehlung gültig ist.