XmlWriter.WriteQualifiedName(String, String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlWriter.cs

Ketika ditimpa di kelas turunan, tulis nama yang memenuhi syarat namespace. Metode ini mencari awalan yang berada dalam cakupan untuk namespace yang diberikan.

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

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

abstract member WriteQualifiedName : string * string -> unit
override this.WriteQualifiedName : string * string -> unit

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

Parameter

localName

String

Nama lokal untuk ditulis.

ns

String

Namespace URI untuk nama tersebut.

Pengecualian

ArgumentException

localName null adalah atau String.Empty.

localName bukan nama yang valid.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Contoh

Contohnya menulis elemen berikut:

<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

Keterangan

Jika ns memetakan ke namespace default saat ini, tidak ada awalan yang dihasilkan.

Saat menulis nilai atribut, metode ini menghasilkan awalan jika ns tidak ditemukan. Saat menulis konten elemen, ia melemparkan pengecualian jika ns tidak ditemukan.

Catatan

Jika kelas yang berasal dari XmlWriter tidak mengambil alih metode localName ini tidak diperiksa untuk menjadi nama XML W3C yang valid. Dalam kasus seperti itu, sebelum memanggil metode ini, validitas string dapat diperiksa dengan IsName metode .

Untuk versi asinkron metode ini, lihat WriteQualifiedNameAsync.