ChtmlTextWriter.OnAttributeRender 方法

定义

确定指定的 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 的值。

返回

如果将特性及其值写入 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类中重写 方法的行为。

适用于

另请参阅