HideDisabledControlAdapter.Render(HtmlTextWriter) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将关联的 Web 控件作为 HTML 写入输出流。
protected public:
override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected internal override void Render(System.Web.UI.HtmlTextWriter writer);
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Friend Overrides Sub Render (writer As HtmlTextWriter)
参数
- writer
- HtmlTextWriter
HtmlTextWriter用于生成和呈现特定于设备的输出的包含方法。
示例
下面的代码示例演示如何重写 Render 方法,以便在启用关联的控件时将 HtmlTextWriter 对象传递给父控件进行呈现。 该代码示例是 HideDisabledControlAdapter 类中的一个较大示例的一部分。
protected override void Render(System.Web.UI.HtmlTextWriter writer)
{
if (Control.ID.StartsWith("Contoso"))
{
if (!Control.Enabled)
{
return;
}
}
base.Render(writer);
}
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
If (Control.ID.StartsWith("Contoso")) Then
If (Not Control.Enabled) Then
Return
End If
End If
MyBase.Render(writer)
End Sub
注解
该方法 Render 将关联的 WebControl 控件作为 HTML 写入输出流。
默认情况下,.NET Framework 调用 Web 服务器控件自己的 Render 方法。 但是,设置该控件的属性后 Adapter ,.NET Framework 将在关联的控件上执行事件的适配器实现 Render 。
该 Render 事件用于对呈现到设备浏览器的标记代码执行修改。 应在生命周期的此阶段之前设置控件属性,并且只设置此处完成的控件的实际标记创建。 在此生命周期的此阶段对控件所做的更改不会保存到视图状态。 若要保存对控件所做的更改,请重写事件 OnPreRender 。
该 Render 事件还允许派生类在不附加委托的情况下处理事件,这是处理派生类中的事件的首选技术。