ChtmlTextWriter.OnAttributeRender 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
确定指定的 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
的值。
与 HtmlTextWriterAttribute 关联的 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类中重写 方法的行为。