Control.Render(HtmlTextWriter) メソッド

定義

提供されたクライアントに表示される内容を書き込む 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 アクセスできます。 true が返され、コレクション内の最初のサーバー コントロールがリテラル テキストである場合 HasControls 、リテラル テキストは 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 ページのコンテンツを生成できます。

適用対象

こちらもご覧ください