Bagikan melalui


XmlWriter.WriteQualifiedName(String, String) Metode

Definisi

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:
 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

Nama lokal untuk ditulis.

ns
String

Namespace URI untuk nama tersebut.

Pengecualian

localName null adalah atau String.Empty.

localName bukan nama yang valid.

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.

Berlaku untuk