HideDisabledControlAdapter.Render(HtmlTextWriter) 方法

定义

命名空间:

System.Web.UI.WebControls.Adapters

程序集:

System.Web.dll

将关联的 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 事件还允许派生类在不附加委托的情况下处理事件，这是处理派生类中的事件的首选技术。

另请参阅

• WebControl
• Control
• WebControlAdapter
• OnPreRender(EventArgs)