HideDisabledControlAdapter.Render メソッド

.NET Framework クラス ライブラリ リファレンス

HideDisabledControlAdapter.Render メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

関連付けられた Web コントロールを、HTML として出力ストリームに書き込みます。

名前空間: System.Web.UI.WebControls.Adapters
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Overrides
 Sub Render ( _
    writer As HtmlTextWriter _
)

Visual Basic (使用法)

Dim writer As HtmlTextWriter

Me.Render(writer)

C#

protected internal override void Render (
    HtmlTextWriter writer
)

C++

protected public:
virtual void Render (
    HtmlTextWriter^ writer
) override

J#

protected void Render (
    HtmlTextWriter writer
)

JScript

protected internal override function
 Render (
    writer : HtmlTextWriter
)

パラメータ

writer

デバイス固有の出力を構築および表示するメソッドを持つ HtmlTextWriter。

解説

Render メソッドは、関連付けられた WebControl コントロールを HTML として出力ストリームに書き込みます。

既定では、.NET Framework は、Web サーバー コントロールの固有の Render メソッドを呼び出します。ただし、そのコントロールの Adapter プロパティを設定すると、.NET Framework は、関連付けられているコントロールの同じプロパティに Render イベントのアダプタを実装します。

Render イベントは、デバイス ブラウザにレンダリングされるマークアップ コードに変更を加える場合に使用されます。ここでは、コントロールの実際のマークアップ作成のみ実行します。コントロールのプロパティは、有効期間のこの段階の前に設定される必要があります。有効期間のこの段階でコントロールに対して加えられた変更は、ビューステートには保存されません。コントロールへの変更を保存するには、OnPreRender イベントをオーバーライドします。

Render イベントを使用して、デリゲートを結びつけずに派生クラスでイベントを処理させることもでき、派生クラスでイベントを処理する場合は、この手法をお勧めします。

使用例

Render メソッドをオーバーライドして、関連付けられたコントロールが有効な場合に、HtmlTextWriter オブジェクトをレンダリングのために親コントロールに渡す方法を次のコード例に示します。このコード例は、HideDisabledControlAdapter クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

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

C#

protected override void Render(System.Web.UI.HtmlTextWriter
 writer)
{
    if (Control.ID.StartsWith("Contoso"))
    {
        if (!Control.Enabled)
        {
            return;
        }
    }

    base.Render(writer);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HideDisabledControlAdapter クラス
HideDisabledControlAdapter メンバ
System.Web.UI.WebControls.Adapters 名前空間
WebControl クラス
Control
WebControlAdapter
OnPreRender