次の方法で共有


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 メソッドは、Control.Controls プロパティを介してアクセスできる、ControlCollection オブジェクトに格納されている子コントロールがサーバー コントロールにあるかどうかを判断するために使用されます。 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 ページのコンテンツを生成できます。

適用対象

こちらもご覧ください