次の方法で共有

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 イベントを使用すると、派生クラスはデリゲートをアタッチせずにイベントを処理できます。これは、派生クラスでイベントを処理する場合に推奨される手法です。

適用対象

こちらもご覧ください