HtmlTable クラス
アセンブリ: System.Web (system.web.dll 内)
構文
解説
HtmlTable コントロールを使用して、サーバー上の HTML <table> 要素をプログラムで制御します。これによって Web ページにテーブルを作成できます。
さらに、BgColor、Border、BorderColor、Height、Width の各プロパティを設定して、<table> 要素の外観を動的に変更できます。また、Align、CellPadding、および CellSpacing の各プロパティを設定すると、セルの内容の表示方法を制御できます。
HtmlTable コントロールの行はコントロールの Rows プロパティに格納されます。これによってテーブルの各行にプログラムによってアクセスできます。
メモ |
---|
複合テーブル モデルはサポートされていません。<caption>、<col>、<colgroup>、<tbody>、<thead>、<tfoot> の各要素が入れ子になっている HtmlTable コントロールを持つことはできません。これらの要素は警告なしに削除され、出力 HTML には表示されません。これらのテーブル モデル要素を HtmlTable コントロールの Control.Controls コレクションにプログラムを使って追加しようとすると、例外がスローされます。 |
HtmlTable のインスタンスの初期プロパティ値の一覧については、HtmlTable コンストラクタのトピックを参照してください。
HtmlTable コントロールを使用して、テーブル内の情報を表示する方法を次のコード例に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <script runat="server"> Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) ' Set the properties of the HtmlTable with the ' user selections. Table1.BgColor = BgColorSelect.Value Table1.Border = CInt(BorderSelect.Value) Table1.BorderColor = BorderColorSelect.Value Table1.Height = HeightSelect.Value Table1.Width = WidthSelect.Value End Sub </script> <html> <head> <title>HtmlTable Example</title> </head> <body> <form runat="server"> <h3>HtmlTable Example</h3> <table id="Table1" Border="1" BorderColor="black" runat="server"> <tr> <th> Column 1 </th> <th> Column 2 </th> <th> Column 3 </th> </tr> <tr> <td> Cell 1 </td> <td> Cell 2 </td> <td> Cell 3 </td> </tr> <tr> <td> Cell 4 </td> <td> Cell 5 </td> <td> Cell 6 </td> </tr> </table> <hr> Select the display settings: <br><br> BgColor: <select id="BgColorSelect" runat="server"> <option Value="Red">Red</option> <option Value="Blue">Blue</option> <option Value="Green">Green</option> <option Value="Black">Black</option> <option Value="White" Selected>White</option> </select> Border: <select id="BorderSelect" runat="server"> <option Value="0">0</option> <option Value="1" Selected>1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> BorderColor: <select id="BorderColorSelect" runat="server"> <option Value="Red">Red</option> <option Value="Blue">Blue</option> <option Value="Green">Green</option> <option Value="Black" Selected>Black</option> <option Value="White">White</option> </select> <br><br> Height: <select id="HeightSelect" runat="server"> <option Value="0">0</option> <option Value="100">100</option> <option Value="150">150</option> <option Value="200">200</option> <option Value="250">250</option> </select> Width: <select id="WidthSelect" runat="server"> <option Value="0">0</option> <option Value="200">200</option> <option Value="250">250</option> <option Value="300">300</option> <option Value="350">350</option> </select> <br><br> <input type="button" value="Generate Table" OnServerClick ="Button_Click" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <script runat="server"> void Button_Click(Object sender, EventArgs e) { // Set the properties of the HtmlTable with the // user selections. Table1.BgColor = BgColorSelect.Value; Table1.Border = Convert.ToInt32(BorderSelect.Value); Table1.BorderColor = BorderColorSelect.Value; Table1.Height = HeightSelect.Value; Table1.Width = WidthSelect.Value; } </script> <html> <head> <title>HtmlTable Example</title> </head> <body> <form runat="server"> <h3>HtmlTable Example</h3> <table id="Table1" Border="1" BorderColor="black" runat="server"> <tr> <th> Column 1 </th> <th> Column 2 </th> <th> Column 3 </th> </tr> <tr> <td> Cell 1 </td> <td> Cell 2 </td> <td> Cell 3 </td> </tr> <tr> <td> Cell 4 </td> <td> Cell 5 </td> <td> Cell 6 </td> </tr> </table> <hr> Select the display settings: <br><br> BgColor: <select id="BgColorSelect" runat="server"> <option Value="Red">Red</option> <option Value="Blue">Blue</option> <option Value="Green">Green</option> <option Value="Black">Black</option> <option Value="White" Selected>White</option> </select> Border: <select id="BorderSelect" runat="server"> <option Value="0">0</option> <option Value="1" Selected>1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> BorderColor: <select id="BorderColorSelect" runat="server"> <option Value="Red">Red</option> <option Value="Blue">Blue</option> <option Value="Green">Green</option> <option Value="Black" Selected>Black</option> <option Value="White">White</option> </select> <br><br> Height: <select id="HeightSelect" runat="server"> <option Value="0">0</option> <option Value="100">100</option> <option Value="150">150</option> <option Value="200">200</option> <option Value="250">250</option> </select> Width: <select id="WidthSelect" runat="server"> <option Value="0">0</option> <option Value="200">200</option> <option Value="250">250</option> <option Value="300">300</option> <option Value="350">350</option> </select> <br><br> <input type="button" value="Generate Table" OnServerClick ="Button_Click" runat="server"/> </form> </body> </html>
<%@ Page Language="JScript" AutoEventWireup="True" %> <script runat="server"> function Button_Click(sender : Object, e : EventArgs) { // Set the properties of the HtmlTable with the // user selections. Table1.BgColor = BgColorSelect.Value; Table1.Border = Convert.ToInt32(BorderSelect.Value); Table1.BorderColor = BorderColorSelect.Value; Table1.Height = HeightSelect.Value; Table1.Width = WidthSelect.Value; } </script> <html> <head> <title>HtmlTable Example</title> </head> <body> <form runat="server"> <h3>HtmlTable Example</h3> <table id="Table1" Border="1" BorderColor="black" runat="server"> <tr> <th> Column 1 </th> <th> Column 2 </th> <th> Column 3 </th> </tr> <tr> <td> Cell 1 </td> <td> Cell 2 </td> <td> Cell 3 </td> </tr> <tr> <td> Cell 4 </td> <td> Cell 5 </td> <td> Cell 6 </td> </tr> </table> <hr> Select the display settings: <br><br> BgColor: <select id="BgColorSelect" runat="server"> <option Value="Red">Red</option> <option Value="Blue">Blue</option> <option Value="Green">Green</option> <option Value="Black">Black</option> <option Value="White" Selected>White</option> </select> Border: <select id="BorderSelect" runat="server"> <option Value="0">0</option> <option Value="1" Selected>1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> BorderColor: <select id="BorderColorSelect" runat="server"> <option Value="Red">Red</option> <option Value="Blue">Blue</option> <option Value="Green">Green</option> <option Value="Black" Selected>Black</option> <option Value="White">White</option> </select> <br><br> Height: <select id="HeightSelect" runat="server"> <option Value="0">0</option> <option Value="100">100</option> <option Value="150">150</option> <option Value="200">200</option> <option Value="250">250</option> </select> Width: <select id="WidthSelect" runat="server"> <option Value="0">0</option> <option Value="200">200</option> <option Value="250">250</option> <option Value="300">300</option> <option Value="350">350</option> </select> <br><br> <input type="button" value="Generate Table" OnServerClick ="Button_Click" runat="server"/> </form> </body> </html>
HtmlTable コントロールを動的に作成する方法を次のコード例に示します。
<%@ Page Language="VB" %> <script runat="server"> Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Dim i As Integer Dim j As Integer Dim row As HtmlTableRow Dim cell As HtmlTableCell ' Get the number of rows and columns selected by the user. Dim numrows As Integer = CInt(Select1.Value) Dim numcells As Integer = CInt(Select2.Value) ' Iterate through the rows. For j = 0 To numrows - 1 ' Create a new row. row = New HtmlTableRow() ' Provide a different background color for alternating rows. If (j Mod 2) = 1 Then row.BgColor = "Gray" End If ' Iterate through the cells of a row. For i = 0 To numcells - 1 ' Create a new cell and add it to the HtmlTableRow ' Cells collection. cell = New HtmlTableCell() cell.Controls.Add(New LiteralControl("row " & _ j.ToString() & _ ", cell " & _ i.ToString())) row.Cells.Add(cell) Next i ' Add the row to the HtmlTable Rows collection. Table1.Rows.Add(row) Next j End Sub </script> <html> <head> <title>HtmlTable Example</title> </head> <body> <form runat="server"> <h3>HtmlTable Example</h3> <table id="Table1" CellPadding="5" CellSpacing="0" Border="1" BorderColor="black" runat="server"/> <hr> Select the number of rows and columns to create: <br><br> Table rows: <select id="Select1" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> Table cells: <select id="Select2" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> <br><br> <input type="submit" value="Generate Table" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" %> <script runat="server"> void Page_Load(Object sender, EventArgs e) { // Get the number of rows and columns selected by the user. int numrows = Convert.ToInt32(Select1.Value); int numcells = Convert.ToInt32(Select2.Value); // Iterate through the rows. for (int j = 0; j < numrows; j++) { // Create a new row and add it to the Rows collection. HtmlTableRow row = new HtmlTableRow(); // Provide a different background color for alternating rows. if (j % 2 == 1) row.BgColor = "Gray"; // Iterate through the cells of a row. for (int i = 0; i < numcells; i++) { // Create a new cell and add it to the HtmlTableRow // Cells collection. HtmlTableCell cell = new HtmlTableCell(); cell.Controls.Add(new LiteralControl("row " + j.ToString() + ", cell " + i.ToString())); row.Cells.Add(cell); } // Add the row to the HtmlTable Rows collection. Table1.Rows.Add(row); } } </script> <html> <head> <title>HtmlTable Example</title> </head> <body> <form runat="server"> <h3>HtmlTable Example</h3> <table id="Table1" CellPadding="5" CellSpacing="0" Border="1" BorderColor="black" runat="server"/> <hr> Select the number of rows and columns to create: <br><br> Table rows: <select id="Select1" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> Table cells: <select id="Select2" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> <br><br> <input type="submit" value="Generate Table" runat="server"/> </form> </body> </html>
<%@ Page Language="JScript" %> <script runat="server"> function Page_Load(sender : Object, e : EventArgs) { // Get the number of rows and columns selected by the user. var numrows : int = Convert.ToInt32(Select1.Value); var numcells : int = Convert.ToInt32(Select2.Value); // Iterate through the rows. for (var j : int = 0; j < numrows; j++) { // Create a new row and add it to the Rows collection. var row : HtmlTableRow = new HtmlTableRow(); // Provide a different background color for alternating rows. if (j%2 == 1) row.BgColor="Gray"; // Iterate through the cells of a row. for (var i : int = 0; i < numcells; i++) { // Create a new cell and add it to the HtmlTableRow // Cells collection. var cell : HtmlTableCell = new HtmlTableCell(); cell.Controls.Add(new LiteralControl("row " + j.ToString() + ", cell " + i.ToString())); row.Cells.Add(cell); } // Add the row to the HtmlTable Rows collection. Table1.Rows.Add(row); } } </script> <html> <head> <title>HtmlTable Example</title> </head> <body> <form runat="server"> <h3>HtmlTable Example</h3> <table id="Table1" CellPadding="5" CellSpacing="0" Border="1" BorderColor="black" runat="server"/> <hr> Select the number of rows and columns to create: <br><br> Table rows: <select id="Select1" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> Table cells: <select id="Select2" runat="server"> <option Value="1">1</option> <option Value="2">2</option> <option Value="3">3</option> <option Value="4">4</option> <option Value="5">5</option> </select> <br><br> <input type="submit" value="Generate Table" runat="server"/> </form> </body> </html>
System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlContainerControl
System.Web.UI.HtmlControls.HtmlTable
プラットフォーム
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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
- HtmlTable クラスのページへのリンク