次の方法で共有


Control.Render メソッド

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

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

構文

'宣言
Protected Friend Overridable Sub Render ( _
    writer As HtmlTextWriter _
)
'使用
Dim writer As HtmlTextWriter

Me.Render(writer)
protected internal virtual void Render (
    HtmlTextWriter writer
)
protected public:
virtual void Render (
    HtmlTextWriter^ writer
)
protected void Render (
    HtmlTextWriter writer
)
protected internal function Render (
    writer : HtmlTextWriter
)
適用できません。

パラメータ

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

解説

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

使用例

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

<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
[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>");
    }
}
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 Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

Control クラス
Control メンバ
System.Web.UI 名前空間
HtmlTextWriter

その他の技術情報

ASP.NET ページのライフ サイクルの概要