XmlWriter.WriteQualifiedName(String, String) Metode

Referensi

Definisi

Ruang nama:: System.Xml

Rakitan:: System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.dll

Rakitan:: netstandard.dll

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

ArgumentException

localNamenull 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.

Berlaku untuk

Share via