XmlWriter.WriteStartAttribute Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Saat ditimpa di kelas turunan, menulis awal atribut.

Overload

Nama	Deskripsi
WriteStartAttribute(String, String, String)	Saat ditimpa di kelas turunan, menulis awalan atribut dengan awalan, nama lokal, dan URI namespace yang ditentukan.
WriteStartAttribute(String)	Menulis awal atribut dengan nama lokal yang ditentukan.
WriteStartAttribute(String, String)	Menulis awal atribut dengan nama lokal dan URI namespace yang ditentukan.

Keterangan

Untuk versi asinkron dari metode ini, lihat WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Sumber:

XmlWriter.cs

Saat ditimpa di kelas turunan, menulis awalan atribut dengan awalan, nama lokal, dan URI namespace yang ditentukan.

public:
 abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ ns);

public abstract void WriteStartAttribute(string? prefix, string localName, string? ns);

abstract member WriteStartAttribute : string * string * string -> unit

Public MustOverride Sub WriteStartAttribute (prefix As String, localName As String, ns As String)

Parameter

prefix

String

Awalan namespace atribut.

localName

String

Nama lokal atribut.

ns

String

URI namespace layanan untuk atribut .

Pengecualian

EncoderFallbackException

Ada karakter dalam buffer yang merupakan karakter XML yang valid tetapi tidak valid untuk pengodean output. Misalnya, jika pengodean output adalah ASCII, Anda hanya boleh menggunakan karakter dari rentang 0 hingga 127 untuk nama elemen dan atribut. Karakter yang tidak valid mungkin berada dalam argumen metode ini atau dalam argumen metode sebelumnya yang menulis ke buffer. Karakter tersebut diloloskan oleh referensi entitas karakter jika memungkinkan (misalnya, dalam node teks atau nilai atribut). Namun, referensi entitas karakter tidak diizinkan dalam elemen dan nama atribut, komentar, instruksi pemrosesan, atau bagian CDATA.

InvalidOperationException

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

Keterangan

Metode ini memungkinkan Anda menulis nilai menggunakan beberapa metode Tulis.

Untuk versi asinkron dari metode ini, lihat WriteStartAttributeAsync.

WriteStartAttribute(String)

Sumber:

XmlWriter.cs

Menulis awal atribut dengan nama lokal yang ditentukan.

public:
 void WriteStartAttribute(System::String ^ localName);

public void WriteStartAttribute(string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

Parameter

localName

String

Nama lokal atribut.

Pengecualian

InvalidOperationException

Penulis ditutup.

-atau-

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

EncoderFallbackException

Ada karakter dalam buffer yang merupakan karakter XML yang valid tetapi tidak valid untuk pengodean output. Misalnya, jika pengodean output adalah ASCII, Anda hanya boleh menggunakan karakter dari rentang 0 hingga 127 untuk nama elemen dan atribut. Karakter yang tidak valid mungkin berada dalam argumen metode ini atau dalam argumen metode sebelumnya yang menulis ke buffer. Karakter tersebut diloloskan oleh referensi entitas karakter jika memungkinkan (misalnya, dalam node teks atau nilai atribut). Namun, referensi entitas karakter tidak diizinkan dalam elemen dan nama atribut, komentar, instruksi pemrosesan, atau bagian CDATA.

Keterangan

Metode ini memungkinkan Anda menulis nilai menggunakan beberapa metode Tulis.

Untuk versi asinkron dari metode ini, lihat WriteStartAttributeAsync.

WriteStartAttribute(String, String)

Sumber:

XmlWriter.cs

Menulis awal atribut dengan nama lokal dan URI namespace yang ditentukan.

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

public void WriteStartAttribute(string localName, string? ns);

member this.WriteStartAttribute : string * string -> unit

Public Sub WriteStartAttribute (localName As String, ns As String)

Parameter

localName

String

Nama lokal atribut.

ns

String

URI namespace atribut.

Pengecualian

EncoderFallbackException

Ada karakter dalam buffer yang merupakan karakter XML yang valid tetapi tidak valid untuk pengodean output. Misalnya, jika pengodean output adalah ASCII, Anda hanya boleh menggunakan karakter dari rentang 0 hingga 127 untuk nama elemen dan atribut. Karakter yang tidak valid mungkin berada dalam argumen metode ini atau dalam argumen metode sebelumnya yang menulis ke buffer. Karakter tersebut diloloskan oleh referensi entitas karakter jika memungkinkan (misalnya, dalam node teks atau nilai atribut). Namun, referensi entitas karakter tidak diizinkan dalam elemen dan nama atribut, komentar, instruksi pemrosesan, atau bagian CDATA.

InvalidOperationException

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

Contoh

Lihat XmlTextWriter.WriteStartAttribute contoh menggunakan metode ini.

Keterangan

Ini adalah versi WriteAttributeString yang lebih canggih yang memungkinkan Anda menulis nilai atribut menggunakan beberapa metode tulis, seperti , WriteString, dan sebagainyaWriteQualifiedName.

Untuk versi asinkron dari metode ini, lihat WriteStartAttributeAsync.

Lihat juga

• WriteEndAttribute()