HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) 方法

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

參數

傳回

一定是 true。

範例

下列程式碼範例示範如何覆寫 OnTagRender 方法。 Font如果正在轉譯專案，覆寫會 OnTagRenderIsAttributeDefined 使用 方法來判斷是否 Size 正在轉譯屬性。 如果沒有，它會使用 AddAttribute 方法來建立 Size 屬性，並將其值設定為 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

備註

方法 HtmlTextWriter 的 OnTagRender 類別實作一律會傳 true 回 。 覆 OnTagRender 寫可以判斷專案是否會轉譯至頁面。

給繼承者的注意事項

如果您繼承自 HtmlTextWriter 類別，您可以覆寫 OnTagRender(String, HtmlTextWriterTag) 方法以傳回 false 以防止標記專案完全轉譯或呈現特定標記語言。 例如，如果您不想讓衍生自 HtmlTextWriter 的物件轉 <font> 譯專案，您可以在要求包含 <font> 元素的頁面時覆寫 OnTagRender(String, HtmlTextWriterTag) 方法以傳回 false 。

適用於

另請參閱

• TextWriter
• HtmlTextWriterTag