Language

Control.Render(HtmlTextWriter) メソッド

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.dll

指定した HtmlTextWriter オブジェクトにサーバー コントロールのコンテンツを送信します。このオブジェクトは、クライアントにレンダリングされるコンテンツを書き込みます。

protected:
 virtual void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
 virtual void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void Render(System.Web.UI.HtmlTextWriter writer);
protected internal virtual void Render(System.Web.UI.HtmlTextWriter writer);
abstract member Render : System.Web.UI.HtmlTextWriter -> unit
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub Render (writer As HtmlTextWriter)
Protected Friend Overridable Sub Render (writer As HtmlTextWriter)

パラメーター

writer
HtmlTextWriter

サーバー コントロールのコンテンツを受け取る HtmlTextWriter オブジェクト。

例

次のコード例では、 Render メソッドのオーバーライドを示します。 HasControls メソッドは、ControlCollection プロパティを介してアクセスできる、Control.Controls オブジェクトに格納されている子コントロールがサーバー コントロールにあるかどうかを判断するために使用されます。 HasControlsが true を返し、コレクション内の最初のサーバー コントロールがリテラル テキストである場合、リテラル テキストが HTML 文字列に追加されます。

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void Render(HtmlTextWriter output) {
    if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
        output.Write("<H2>Your Message: " + ((LiteralControl) Controls[0]).Text + "</H2>");
    }
}

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(Output As HtmlTextWriter)
    If HasControls() And TypeOf Controls(0) Is LiteralControl
        Dim Ctrl As LiteralControl = CType(Controls(0), LiteralControl)
        Output.Write("<H2>Your Message: " & Ctrl.Text & "</H2>")
    End If
End Sub

注釈

カスタム サーバー コントロールを開発するときに、このメソッドをオーバーライドして、ASP.NET ページのコンテンツを生成できます。

適用対象

こちらもご覧ください