HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Menentukan apakah elemen markup yang ditentukan akan dirender ke halaman permintaan.

protected:
 virtual bool OnTagRender(System::String ^ name, System::Web::UI::HtmlTextWriterTag key);

protected virtual bool OnTagRender(string name, System.Web.UI.HtmlTextWriterTag key);

abstract member OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
override this.OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool

Protected Overridable Function OnTagRender (name As String, key As HtmlTextWriterTag) As Boolean

Parameter

name

String

String yang berisi nama elemen yang akan dirender.

key

HtmlTextWriterTag

Yang HtmlTextWriterTag terkait dengan elemen .

Mengembalikan

Boolean

Selalu true.

Contoh

Contoh kode berikut menunjukkan cara mengambil OnTagRender alih metode . Font Jika elemen sedang dirender, OnTagRender penimpaan IsAttributeDefined menggunakan metode untuk menentukan apakah Size atribut sedang dirender. Jika tidak, metode ini menggunakan AddAttribute metode untuk membuat Size atribut dan mengatur nilainya ke 20pt.

// If a <font> element is to be rendered, check whether it contains
// a size attribute. If it does not, add one and set its value to
// 20 points, then return true.
protected override bool OnTagRender(string name, HtmlTextWriterTag key)
{

    if (key == HtmlTextWriterTag.Font)
    {
        if (!(IsAttributeDefined(HtmlTextWriterAttribute.Size)))
        {
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt");
            return true;
        }
    }

    // If the element is not a <font> element, use
    // the base functionality of the OnTagRenderMethod.
    return base.OnTagRender(name, key);
}

' If a <font> element is to be rendered, check whether it contains
' a size attribute. If it does not, add one and set its value to
' 20 points, then return true.
Protected Overrides Function OnTagRender( _
    name As String, _
    key As HtmlTextWriterTag) _
As Boolean

    If (key = HtmlTextWriterTag.Font) Then
        If Not (IsAttributeDefined(HtmlTextWriterAttribute.Size)) Then
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt")
            Return True
        End If
    End If

    ' If the element is not a <font> element, use
    ' the base functionality of the OnTagRenderMethod.
    Return MyBase.OnTagRender(name, key)
End Function

Keterangan

Implementasi HtmlTextWriter kelas metode OnTagRender selalu mengembalikan true. Penimpaan OnTagRender dapat menentukan apakah elemen akan dirender ke halaman.

Catatan Bagi Inheritor

Jika Anda mewarisi dari HtmlTextWriter kelas , Anda dapat mengambil alih OnTagRender(String, HtmlTextWriterTag) metode untuk kembali false guna mencegah elemen markup dirender sama sekali atau untuk bahasa markup tertentu. Misalnya, jika Anda tidak ingin objek yang berasal dari HtmlTextWriter untuk merender <font> elemen, Anda dapat mengambil alih OnTagRender(String, HtmlTextWriterTag) metode untuk mengembalikan false ketika halaman diminta yang berisi <font> elemen.

Lihat juga

• TextWriter
• HtmlTextWriterTag