WebControl.AddAttributesToRender(HtmlTextWriter) 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 dan gaya HTML yang perlu dirender ke yang ditentukan HtmlTextWriterTag. Metode ini digunakan terutama oleh pengembang kontrol.
protected:
virtual void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void AddAttributesToRender (System.Web.UI.HtmlTextWriter writer);
abstract member AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub AddAttributesToRender (writer As HtmlTextWriter)
Parameter
- writer
- HtmlTextWriter
HtmlTextWriter yang mewakili aliran output untuk merender konten HTML pada klien.
Contoh
Contoh berikut menunjukkan cara membuat kelas yang berasal dari WebControl kelas . Implementasi AddAttributesToRender dasar metode ini ditimpa untuk menambahkan atribut yang sesuai dengan kelas turunan HtmlTextWriter dalam aliran output.
namespace ControlTest
{
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
// Renders the following HTML:
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl: WebControl {
public MyWebControl() : base(HtmlTextWriterTag.Span)
{ }
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void AddAttributesToRender(HtmlTextWriter writer)
{
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
base.AddAttributesToRender(writer);
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void RenderContents(HtmlTextWriter writer)
{
writer.Write("Custom Contents");
base.RenderContents(writer);
}
}
}
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace ControlTest
' Renders the following HTML:
' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
Public Class MyWebControl
Inherits WebControl
Public Sub New()
MyBase.New(HtmlTextWriterTag.Span)
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
MyBase.AddAttributesToRender(writer)
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
writer.Write("Custom Contents")
MyBase.RenderContents(writer)
End Sub
End Class
End Namespace 'ControlTest
Keterangan
Untuk merender atribut dan gaya untuk kontrol Server Web pada klien, Anda biasanya memanggil AddAttribute metode dan HtmlTextWriter.AddStyleAttribute untuk menyisipkan setiap atribut dan gaya satu per satu ke HtmlTextWriter aliran output. Untuk menyederhanakan proses, metode ini merangkum semua panggilan ke HtmlTextWriter.AddAttribute metode dan HtmlTextWriter.AddStyleAttribute untuk setiap atribut dan gaya yang terkait dengan kontrol server Web. Semua atribut dan gaya dimasukkan ke HtmlTextWriter dalam aliran output dalam satu panggilan metode. Metode ini biasanya ditimpa oleh pengembang kontrol di kelas turunan untuk menyisipkan atribut dan gaya yang sesuai ke HtmlTextWriter aliran output untuk kelas .
Catatan
Metode AddAttributesToRender tidak dapat digunakan untuk menyisipkan skrip klien. Untuk menggunakan skrip klien, lihat ClientScriptManager kelas .