HtmlTextWriter.AddAttribute Metode
Definisi
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 -> unitPublic 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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)Parameter
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 -> unitPublic 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.
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 .
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
- TextWriter
- HttpRequest
- RenderBeginTag
- HtmlTextWriterAttribute
- HtmlAttributeEncode(String, TextWriter)
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 -> unitProtected 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 .
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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)Parameter
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
- TextWriter
- HttpRequest
- RenderBeginTag
- HtmlTextWriterAttribute
- HtmlAttributeEncode(String, TextWriter)
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk