HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
确定是否向请求页面呈现指定的标记元素。
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 -> boolProtected Overridable Function OnTagRender (name As String, key As HtmlTextWriterTag) As Boolean参数
- name
- String
包含要呈现的元素名称的字符串。
与元素关联的 HtmlTextWriterTag。
返回
总是为 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。
