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如果正在呈现元素，则OnTagRender替代使用 IsAttributeDefined 方法确定是否呈现特性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>元素，则可以重写 方法，OnTagRender(String, HtmlTextWriterTag)以便在请求<font>包含元素的页面时返回false。

另请参阅

• TextWriter
• HtmlTextWriterTag