ChtmlTextWriter.OnAttributeRender 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

确定指定的 cHTML 特性及其值是否将呈现给请求页。 可以在从 OnAttributeRender(String, String, HtmlTextWriterAttribute) 类派生的类中重写 ChtmlTextWriter 方法，以筛选出不希望在支持 cHTML 的设备上呈现的特性。

protected:
 override bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected override bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool

Protected Overrides Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean

参数

name

String

要呈现的 cHTML 特性。

value

String

分配给 name 的值。

key

HtmlTextWriterAttribute

与 HtmlTextWriterAttribute 关联的 name。

返回

Boolean

如果将特性及其值写入 ChtmlTextWriter 输入流，则为 true；否则为 false。

示例

下面的代码示例演示如何使用替代 OnAttributeRender 方法的自定义类，以防止将 bgcolor 特性写入 cHTML 输出流。 然后，它从 ChtmlTextWriter 类调用基OnAttributeRender方法提供的功能，以确保也使用其默认行为。

此代码示例是为 ChtmlTextWriter 类提供的一个更大示例的一部分。

// Override the OnAttributeRender method to
// not render the bgcolor attribute, which is
// not supported in CHTML.
protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
{
    if (String.Equals("bgcolor", name))
    {
        return false;
    }
    
    // Call the ChtmlTextWriter version of the
    // the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' Override the OnAttributeRender method to
' not render the bgcolor attribute, which is 
' not supported in CHTML.
Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
    If (String.Equals("bgcolor", name)) Then
        Return False
    End If

    ' Call the ChtmlTextWriter version of 
    ' the OnAttributeRender method.
    MyBase.OnAttributeRender(name, value, key)

End Function

注解

默认情况下， OnAttributeRender 方法阻止将属性中列出的 GlobalSuppressedAttributes 全局抑制属性和属性中列出的 SuppressedAttributes 特定于元素的抑制特性写入输出流。 可以在派生自 ChtmlTextWriter 类的OnAttributeRender类中重写 方法的行为。

另请参阅

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)