HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

判斷指定的標記項目是否將在提出要求的網頁上呈現。

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

參數

name

String

字串，包含要呈現的項目名稱。

key

HtmlTextWriterTag

與項目相關聯的 HtmlTextWriterTag。

傳回

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