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。

例

次のコード例では、関連付けられたコントロールが有効になっている場合に、オブジェクトを親コントロールに渡HtmlTextWriterしてレンダリングするメソッドをオーバーライドRenderする方法を示します。 このコード例は、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)