Control.Render メソッド

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

Control.Render メソッド

提供されたクライアントに表示される内容を書き込む HtmlTextWriter オブジェクトに、サーバー コントロールの内容を送信します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim writer As HtmlTextWriter

Me.Render(writer)

C#

protected internal virtual void Render (
    HtmlTextWriter writer
)

C++

protected public:
virtual void Render (
    HtmlTextWriter^ writer
)

J#

protected void Render (
    HtmlTextWriter writer
)

JScript

protected internal function
 Render (
    writer : HtmlTextWriter
)

パラメータ

writer

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

解説

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

使用例

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

Visual Basic

<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

C#

[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>");
    }
}

JScript

protected override function Render(output :
 HtmlTextWriter) {
var securityperm : SecurityPermission;
         securityperm = new SecurityPermission(SecurityPermissionFlag.SerializationFormatter);
         securityperm.Demand();
    if ( (HasControls()) && (typeof(Controls[0]) == LiteralControl)
 ) {
        output.Write("<H2>Your Message: " + (LiteralControl(Controls[0])).Text
 + "</H2>");
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, 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、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
HtmlTextWriter
その他の技術情報
ASP.NET ページのライフ サイクルの概要