Table.RenderContents(HtmlTextWriter) メソッド

定義

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

テーブル コントロール内の行を、指定したライターにレンダリングします。

protected:
 override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
 override void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);
protected override void RenderContents(System.Web.UI.HtmlTextWriter writer);
protected internal override void RenderContents(System.Web.UI.HtmlTextWriter writer);
override this.RenderContents : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub RenderContents (writer As HtmlTextWriter)
Protected Friend Overrides Sub RenderContents (writer As HtmlTextWriter)

パラメーター

writer
HtmlTextWriter

HTML コンテンツをクライアントにレンダリングする出力ストリームを表す HtmlTextWriter 。

例外

HttpException

テーブル セクションは順序が整っていません。

例

次のコード例は、カスタム RenderContents サーバー コントロールのヘッダー行を常に挿入するように、カスタム サーバー コントロールのTable メソッドをオーバーライドする方法を示しています。

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>Custom Table - RenderContents - C# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Table - RenderContents - C# Example</h3>
            
            <aspSample:CustomTableRenderContents 
              id="Table1" 
              runat="server" 
              GridLines="Both">
        <asp:TableRow>
          <asp:TableCell>Row 0, Col 0</asp:TableCell>
          <asp:TableCell>Row 0, Col 1</asp:TableCell>
        </asp:TableRow>
        <asp:TableRow>
          <asp:TableCell>Row 1, Col 0</asp:TableCell>
          <asp:TableCell>Row 1, Col 1</asp:TableCell>
        </asp:TableRow>
      </aspSample:CustomTableRenderContents>
        
        </form>
    </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>Custom Table - RenderContents - VB.NET Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Table - RenderContents - VB.NET Example</h3>

            <aspSample:CustomTableRenderContents id="Table1" runat="server" GridLines="Both">
                <asp:TableRow>
                    <asp:TableCell>Row 0, Col 0</asp:TableCell>
                    <asp:TableCell>Row 0, Col 1</asp:TableCell>
                </asp:TableRow>
                <asp:TableRow>
                    <asp:TableCell>Row 1, Col 0</asp:TableCell>
                    <asp:TableCell>Row 1, Col 1</asp:TableCell>
                </asp:TableRow>
            </aspSample:CustomTableRenderContents>
        </form>
    </body>
</html>

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomTableRenderContents : System.Web.UI.WebControls.Table
  {
    protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
      // Insert a header row.
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr);
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
      writer.Write("Col 0");
      writer.RenderEndTag();
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
      writer.Write("Col 1");
      writer.RenderEndTag();
      writer.RenderEndTag();

      // Call the base RenderContents method.
      base.RenderContents(writer);
    }
  }
}

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomTableRenderContents
        Inherits System.Web.UI.WebControls.Table

        Protected Overrides Sub RenderContents(ByVal writer As System.Web.UI.HtmlTextWriter)

            ' Insert a header row.
            writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr)
            writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th)
            writer.Write("Col 0")
            writer.RenderEndTag()
            writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th)
            writer.Write("Col 1")
            writer.RenderEndTag()
            writer.RenderEndTag()

            ' Call the base RenderContents method.
            MyBase.RenderContents(writer)
        End Sub
    End Class
End Namespace

注釈

このメソッドは、 Table コントロールからカスタム クラスを派生するときに、主にコントロール開発者によって使用されます。

Table コントロールは、テーブルのRenderContentsをレンダリングするRowsを実装します。

適用対象

こちらもご覧ください