HtmlTextWriter.AddAttribute Metode

Referensi

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

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.

Menambahkan atribut markup dan nilai yang ditentukan ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode .

Overload

AddAttribute(String, String)	Menambahkan atribut markup dan nilai yang ditentukan ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode .
AddAttribute(HtmlTextWriterAttribute, String)	Menambahkan atribut markup dan nilai atribut ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode .
AddAttribute(String, String, Boolean)	Menambahkan atribut markup dan nilai yang ditentukan ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode , dengan pengodean opsional.
AddAttribute(String, String, HtmlTextWriterAttribute)	Menambahkan atribut dan nilai markup yang ditentukan, bersama dengan HtmlTextWriterAttribute nilai enumerasi, ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode .
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Menambahkan atribut markup dan nilai atribut ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode , dengan pengodean opsional.

AddAttribute(String, String)

Menambahkan atribut markup dan nilai yang ditentukan ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode .

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute (string name, string value);

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

Public Overridable Sub AddAttribute (name As String, value As String)

Parameter

name: String

String yang berisi nama atribut yang akan ditambahkan.

value: String

String yang berisi nilai untuk ditetapkan ke atribut .

Contoh

Contoh kode berikut menunjukkan cara memanggil AddAttribute metode sebelum memanggil RenderBeginTag metode . Kode ini memanggil dua kelebihan beban AddAttribute yang berbeda dan dua kelebihan beban AddStyleAttribute yang berbeda sebelum memanggil RenderBeginTag metode untuk merender <span> elemen ke aliran output. Metode AddAttribute(String, String) ini digunakan untuk menentukan atribut kustom bernama CustomAttribute dan nilai kustom bernama CustomAttributeValue untuk elemen yang dirender <span> kode ini.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;

' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

Keterangan

AddAttribute Gunakan kelebihan beban AddAttribute(String, String) metode jika atribut bukan salah HtmlTextWriterAttribute satu nilai, atau jika atribut tidak diketahui sampai run time.

Untuk instans elemen markup tertentu, kelas mempertahankan daftar atribut untuk elemen tersebut HtmlTextWriter . Ketika metode dipanggil RenderBeginTag , atribut apa pun yang ditambahkan oleh AddAttribute metode dirender ke tag pembuka elemen. Daftar atribut kemudian dihapus dari HtmlTextWriter objek .

Pola pengkodian untuk merender elemen markup adalah sebagai berikut:

AddAttribute Gunakan metode untuk menambahkan atribut apa pun ke elemen .
Gunakan metode RenderBeginTag.
Gunakan metode lain sesuai kebutuhan untuk merender konten yang ditemukan di antara tag pembuka dan penutup elemen.
Gunakan metode RenderEndTag.

Lihat juga

Berlaku untuk

AddAttribute(HtmlTextWriterAttribute, String)

Menambahkan atribut markup dan nilai atribut ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode .

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Parameter

key: HtmlTextWriterAttribute

yang HtmlTextWriterAttribute mewakili atribut markup untuk ditambahkan ke aliran output.

value: String

String yang berisi nilai untuk ditetapkan ke atribut .

Contoh

Contoh kode berikut menunjukkan cara menggunakan AddAttribute kelebihan beban AddAttribute(HtmlTextWriterAttribute, String) metode untuk menambahkan Onclick atribut ke elemen markup, lalu mengatur nilainya ke kode ECMAScript berikut:

alert('Hello');

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Keterangan

AddAttribute Gunakan kelebihan beban AddAttribute(HtmlTextWriterAttribute, String) metode untuk merender atribut markup standar.

Untuk instans elemen markup tertentu, kelas mempertahankan daftar atribut untuk elemen tersebut HtmlTextWriter . Ketika metode dipanggil RenderBeginTag , atribut apa pun yang ditambahkan oleh AddAttribute metode dirender ke tag pembuka elemen . Daftar atribut kemudian dihapus dari HtmlTextWriter.

Pola pengkodian untuk merender elemen markup adalah sebagai berikut:

AddAttribute Gunakan metode untuk menambahkan atribut apa pun ke elemen .
Gunakan metode RenderBeginTag.
Gunakan metode lain sesuai kebutuhan untuk merender konten yang ditemukan di antara tag pembuka dan penutup elemen.
Gunakan metode RenderEndTag.

Lihat juga

Berlaku untuk

AddAttribute(String, String, Boolean)

Menambahkan atribut markup dan nilai yang ditentukan ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode , dengan pengodean opsional.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

public virtual void AddAttribute (string name, string value, bool fEndode);

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Parameter

name: String

String yang berisi nama atribut yang akan ditambahkan.

value: String

String yang berisi nilai untuk ditetapkan ke atribut .

fEndode: Boolean

true untuk mengodekan atribut dan nilainya; jika tidak, false.

Contoh

Contoh kode berikut menunjukkan cara menggunakan AddAttribute kelebihan beban AddAttribute(String, String, Boolean) metode untuk memastikan bahwa atribut kustom, bernama myattribute, dan nilainya tidak dikodekan untuk <img> elemen.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Keterangan

AddAttribute Gunakan kelebihan beban AddAttribute(String, String, Boolean) metode jika atribut bukan salah HtmlTextWriterAttribute satu nilai, atau jika atribut tidak diketahui sampai run time dan pengodean diperlukan.

AddAttribute(String, String, Boolean) Gunakan metode dengan fEncode diatur ke true, jika atribut mungkin dapat berisi tanda kutip ("), tanda kurang dari (<), atau ampersand (&). Panggilan metode akan mengodekan atribut untuk memenuhi persyaratan perangkat yang meminta. Anda dapat mengatur fEncode ke false, jika Anda tahu bahwa tidak ada karakter ini yang akan dihasilkan, atau jika Anda tahu bahwa atribut sudah dikodekan.

Jika jenis atribut adalah Style, nilai tidak akan dikodekan meskipun fEndode adalah true. Pastikan bahwa nilai gaya mematuhi CSS dan tidak berisi kode berbahaya.

Pola pengkodian untuk merender elemen markup adalah sebagai berikut:

AddAttribute Gunakan metode untuk menambahkan atribut apa pun ke elemen .
Gunakan metode RenderBeginTag.
Gunakan metode lain sesuai kebutuhan untuk merender konten yang ditemukan di antara tag pembuka dan penutup elemen.
Gunakan metode RenderEndTag.

Lihat juga

Berlaku untuk

AddAttribute(String, String, HtmlTextWriterAttribute)

Menambahkan atribut dan nilai markup yang ditentukan, bersama dengan HtmlTextWriterAttribute nilai enumerasi, ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode .

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual void AddAttribute (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Parameter

name: String

String yang berisi nama atribut yang akan ditambahkan.

value: String

String yang berisi nilai untuk ditetapkan ke atribut .

key: HtmlTextWriterAttribute

yang HtmlTextWriterAttribute mewakili atribut .

Keterangan

AddAttribute Gunakan kelebihan beban AddAttribute(String, String, HtmlTextWriterAttribute) metode hanya saat mewarisi dari HtmlTextWriter kelas . Ini memungkinkan Anda membuat baru name dan key berpasangan untuk atribut.

Lihat juga

Berlaku untuk

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Menambahkan atribut markup dan nilai atribut ke tag pembuka elemen yang HtmlTextWriter dibuat objek dengan panggilan berikutnya ke RenderBeginTag metode , dengan pengodean opsional.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Parameter

key: HtmlTextWriterAttribute

yang HtmlTextWriterAttribute mewakili atribut markup untuk ditambahkan ke aliran output.

value: String

String yang berisi nilai untuk ditetapkan ke atribut .

fEncode: Boolean

true untuk mengodekan atribut dan nilainya; jika tidak, false.

Contoh

Contoh kode berikut menunjukkan cara menggunakan AddAttribute(HtmlTextWriterAttribute, String, Boolean) metode untuk memastikan bahwa nilai string yang ditetapkan ke Alt atribut untuk <img> elemen dikodekan untuk perangkat yang meminta.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Keterangan

AddAttribute Gunakan kelebihan beban AddAttribute(HtmlTextWriterAttribute, String, Boolean) metode untuk merender atribut markup standar, dengan pengodean opsional.

Untuk instans elemen markup tertentu, kelas mempertahankan daftar atribut untuk elemen tersebut HtmlTextWriter . Ketika metode dipanggil RenderBeginTag , atribut apa pun yang ditambahkan oleh AddAttribute dirender ke tag pembuka elemen. Daftar atribut kemudian dihapus dari HtmlTextWriter objek .

AddAttribute(HtmlTextWriterAttribute, String, Boolean) Gunakan metode dengan fEncode diatur ke true, jika atribut mungkin dapat berisi tanda kutip ("), tanda kurang dari (<), atau ampersand (&). Panggilan metode akan mengodekan atribut untuk memenuhi persyaratan perangkat yang meminta. Anda dapat mengatur fEncode ke false, jika Anda tahu bahwa tidak ada karakter ini yang akan dihasilkan, atau jika Anda tahu bahwa atribut sudah dikodekan.

Jika jenis atribut adalah Style, nilai tidak akan dikodekan meskipun fEncode adalah true. Pastikan bahwa nilai gaya mematuhi CSS dan tidak berisi kode berbahaya.

Pola pengkodian untuk merender elemen markup adalah sebagai berikut:

AddAttribute Gunakan metode untuk menambahkan atribut apa pun ke elemen .
Gunakan metode RenderBeginTag.
Gunakan metode lain sesuai kebutuhan untuk merender konten yang ditemukan di antara tag pembuka dan penutup elemen.
Gunakan metode RenderEndTag.

Lihat juga

Berlaku untuk

Bagikan melalui

HtmlTextWriter.AddAttribute Metode

Definisi

Overload

AddAttribute(String, String)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddAttribute(HtmlTextWriterAttribute, String)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddAttribute(String, String, Boolean)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

AddAttribute(String, String, HtmlTextWriterAttribute)

Parameter

Keterangan

Lihat juga

Berlaku untuk

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: