共用方式為

Table Web 伺服器控制項宣告式語法

  • 發行項

更新：2007 年 11 月

宣告表格並且讓您以程式的方式操作它。

 <asp:Table     AccessKey="string"     BackColor="color name|#dddddd"     BackImageUrl="uri"     BorderColor="color name|#dddddd"     BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|         Inset|Outset"     BorderWidth="size"     Caption="string"     CaptionAlign="NotSet|Top|Bottom|Left|Right"     CellPadding="integer"     CellSpacing="integer"     CssClass="string"     Enabled="True|False"     EnableTheming="True|False"     EnableViewState="True|False"     Font-Bold="True|False"     Font-Italic="True|False"     Font-Names="string"     Font-Overline="True|False"     Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|         Large|X-Large|XX-Large"     Font-Strikeout="True|False"     Font-Underline="True|False"     ForeColor="color name|#dddddd"     GridLines="None|Horizontal|Vertical|Both"     Height="size"     HorizontalAlign="NotSet|Left|Center|Right|Justify"     ID="string"     OnDataBinding="DataBinding event handler"     OnDisposed="Disposed event handler"     OnInit="Init event handler"     OnLoad="Load event handler"     OnPreRender="PreRender event handler"     OnUnload="Unload event handler"     runat="server"     SkinID="string"     Style="string"     TabIndex="integer"     ToolTip="string"     Visible="True|False"     Width="size" >             <asp:TableFooterRow                 AccessKey="string"                 BackColor="color name|#dddddd"                 BorderColor="color name|#dddddd"                 BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|                     Groove|Ridge|Inset|Outset"                 BorderWidth="size"                 CssClass="string"                 Enabled="True|False"                 EnableTheming="True|False"                 EnableViewState="True|False"                 Font-Bold="True|False"                 Font-Italic="True|False"                 Font-Names="string"                 Font-Overline="True|False"                 Font-Size="string|Smaller|Larger|XX-Small|X-Small|                     Small|Medium|Large|X-Large|XX-Large"                 Font-Strikeout="True|False"                 Font-Underline="True|False"                 ForeColor="color name|#dddddd"                 Height="size"                 HorizontalAlign="NotSet|Left|Center|Right|Justify"                 ID="string"                 OnDataBinding="DataBinding event handler"                 OnDisposed="Disposed event handler"                 OnInit="Init event handler"                 OnLoad="Load event handler"                 OnPreRender="PreRender event handler"                 OnUnload="Unload event handler"                 runat="server"                 SkinID="string"                 Style="string"                 TabIndex="integer"                 TableSection="TableHeader|TableBody|TableFooter"                 ToolTip="string"                 VerticalAlign="NotSet|Top|Middle|Bottom"                 Visible="True|False"                 Width="size" >                         <asp:TableCell                             AccessKey="string"                             AssociatedHeaderCellID="string"                             BackColor="color name|#dddddd"                             BorderColor="color name|#dddddd"                             BorderStyle="NotSet|None|Dotted|Dashed|                                 Solid|Double|Groove|Ridge|Inset|                                 Outset"                             BorderWidth="size"                             ColumnSpan="integer"                             CssClass="string"                             Enabled="True|False"                             EnableTheming="True|False"                             EnableViewState="True|False"                             Font-Bold="True|False"                             Font-Italic="True|False"                             Font-Names="string"                             Font-Overline="True|False"                             Font-Size="string|Smaller|Larger|                                 XX-Small|X-Small|Small|Medium|Large|                                 X-Large|XX-Large"                             Font-Strikeout="True|False"                             Font-Underline="True|False"                             ForeColor="color name|#dddddd"                             Height="size"                             HorizontalAlign="NotSet|Left|Center|                             Right|Justify"                             ID="string"                             OnDataBinding="DataBinding event handler"                             OnDisposed="Disposed event handler"                             OnInit="Init event handler"                             OnLoad="Load event handler"                             OnPreRender="PreRender event handler"                             OnUnload="Unload event handler"                             RowSpan="integer"                             runat="server"                             SkinID="string"                             Style="string"                             TabIndex="integer"                             Text="string"                             ToolTip="string"                             VerticalAlign="NotSet|Top|Middle|Bottom"                             Visible="True|False"                             Width="size"                             Wrap="True|False"                         />                         <asp:TableHeaderCell                             AbbreviatedText="string"                             AccessKey="string"                             AssociatedHeaderCellID="string"                             BackColor="color name|#dddddd"                             BorderColor="color name|#dddddd"                             BorderStyle="NotSet|None|Dotted|Dashed|                                 Solid|Double|Groove|Ridge|Inset|                                 Outset"                             BorderWidth="size"                             CategoryText="string"                             ColumnSpan="integer"                             CssClass="string"                             Enabled="True|False"                             EnableTheming="True|False"                             EnableViewState="True|False"                             Font-Bold="True|False"                             Font-Italic="True|False"                             Font-Names="string"                             Font-Overline="True|False"                             Font-Size="string|Smaller|Larger|                                 XX-Small|X-Small|Small|Medium|Large|                                 X-Large|XX-Large"                             Font-Strikeout="True|False"                             Font-Underline="True|False"                             ForeColor="color name|#dddddd"                             Height="size"                             HorizontalAlign="NotSet|Left|Center|                                 Right|Justify"                             ID="string"                             OnDataBinding="DataBinding event handler"                             OnDisposed="Disposed event handler"                             OnInit="Init event handler"                             OnLoad="Load event handler"                             OnPreRender="PreRender event handler"                             OnUnload="Unload event handler"                             RowSpan="integer"                             runat="server"                             Scope="NotSet|Row|Column"                             SkinID="string"                             Style="string"                             TabIndex="integer"                             Text="string"                             ToolTip="string"                             VerticalAlign="NotSet|Top|Middle|Bottom"                             Visible="True|False"                             Width="size"                             Wrap="True|False"                         />             </asp:TableFooterRow>             <asp:TableHeaderRow                 AccessKey="string"                 BackColor="color name|#dddddd"                 BorderColor="color name|#dddddd"                 BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|                     Groove|Ridge|Inset|Outset"                 BorderWidth="size"                 CssClass="string"                 Enabled="True|False"                 EnableTheming="True|False"                 EnableViewState="True|False"                 Font-Bold="True|False"                 Font-Italic="True|False"                 Font-Names="string"                 Font-Overline="True|False"                 Font-Size="string|Smaller|Larger|XX-Small|X-Small|                     Small|Medium|Large|X-Large|XX-Large"                 Font-Strikeout="True|False"                 Font-Underline="True|False"                 ForeColor="color name|#dddddd"                 Height="size"                 HorizontalAlign="NotSet|Left|Center|Right|Justify"                 ID="string"                 OnDataBinding="DataBinding event handler"                 OnDisposed="Disposed event handler"                 OnInit="Init event handler"                 OnLoad="Load event handler"                 OnPreRender="PreRender event handler"                 OnUnload="Unload event handler"                 runat="server"                 SkinID="string"                 Style="string"                 TabIndex="integer"                 TableSection="TableHeader|TableBody|TableFooter"                 ToolTip="string"                 VerticalAlign="NotSet|Top|Middle|Bottom"                 Visible="True|False"                 Width="size" >                         <asp:TableCell                             AccessKey="string"                             AssociatedHeaderCellID="string"                             BackColor="color name|#dddddd"                             BorderColor="color name|#dddddd"                             BorderStyle="NotSet|None|Dotted|Dashed|                                 Solid|Double|Groove|Ridge|Inset|                                 Outset"                             BorderWidth="size"                             ColumnSpan="integer"                             CssClass="string"                             Enabled="True|False"                             EnableTheming="True|False"                             EnableViewState="True|False"                             Font-Bold="True|False"                             Font-Italic="True|False"                             Font-Names="string"                             Font-Overline="True|False"                             Font-Size="string|Smaller|Larger|                                 XX-Small|X-Small|Small|Medium|Large|                                 X-Large|XX-Large"                             Font-Strikeout="True|False"                             Font-Underline="True|False"                             ForeColor="color name|#dddddd"                             Height="size"                             HorizontalAlign="NotSet|Left|Center|                                 Right|Justify"                             ID="string"                             OnDataBinding="DataBinding event handler"                             OnDisposed="Disposed event handler"                             OnInit="Init event handler"                             OnLoad="Load event handler"                             OnPreRender="PreRender event handler"                             OnUnload="Unload event handler"                             RowSpan="integer"                             runat="server"                             SkinID="string"                             Style="string"                             TabIndex="integer"                             Text="string"                             ToolTip="string"                             VerticalAlign="NotSet|Top|Middle|Bottom"                             Visible="True|False"                             Width="size"                             Wrap="True|False"                         />                         <asp:TableHeaderCell                             AbbreviatedText="string"                             AccessKey="string"                             AssociatedHeaderCellID="string"                             BackColor="color name|#dddddd"                             BorderColor="color name|#dddddd"                             BorderStyle="NotSet|None|Dotted|Dashed|                                 Solid|Double|Groove|Ridge|Inset|                                 Outset"                             BorderWidth="size"                             CategoryText="string"                             ColumnSpan="integer"                             CssClass="string"                             Enabled="True|False"                             EnableTheming="True|False"                             EnableViewState="True|False"                             Font-Bold="True|False"                             Font-Italic="True|False"                             Font-Names="string"                             Font-Overline="True|False"                             Font-Size="string|Smaller|Larger|                                 XX-Small|X-Small|Small|Medium|Large|                                 X-Large|XX-Large"                             Font-Strikeout="True|False"                             Font-Underline="True|False"                             ForeColor="color name|#dddddd"                             Height="size"                             HorizontalAlign="NotSet|Left|Center|                                 Right|Justify"                             ID="string"                             OnDataBinding="DataBinding event handler"                             OnDisposed="Disposed event handler"                             OnInit="Init event handler"                             OnLoad="Load event handler"                             OnPreRender="PreRender event handler"                             OnUnload="Unload event handler"                             RowSpan="integer"                             runat="server"                             Scope="NotSet|Row|Column"                             SkinID="string"                             Style="string"                             TabIndex="integer"                             Text="string"                             ToolTip="string"                             VerticalAlign="NotSet|Top|Middle|Bottom"                             Visible="True|False"                             Width="size"                             Wrap="True|False"                         />             </asp:TableHeaderRow>             <asp:TableRow                 AccessKey="string"                 BackColor="color name|#dddddd"                 BorderColor="color name|#dddddd"                 BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|                     Groove|Ridge|Inset|Outset"                 BorderWidth="size"                 CssClass="string"                 Enabled="True|False"                 EnableTheming="True|False"                 EnableViewState="True|False"                 Font-Bold="True|False"                 Font-Italic="True|False"                 Font-Names="string"                 Font-Overline="True|False"                 Font-Size="string|Smaller|Larger|XX-Small|                     X-Small|Small|Medium|Large|X-Large|XX-Large"                 Font-Strikeout="True|False"                 Font-Underline="True|False"                 ForeColor="color name|#dddddd"                 Height="size"                 HorizontalAlign="NotSet|Left|Center|Right|Justify"                 ID="string"                 OnDataBinding="DataBinding event handler"                 OnDisposed="Disposed event handler"                 OnInit="Init event handler"                 OnLoad="Load event handler"                 OnPreRender="PreRender event handler"                 OnUnload="Unload event handler"                 runat="server"                 SkinID="string"                 Style="string"                 TabIndex="integer"                 TableSection="TableHeader|TableBody|TableFooter"                 ToolTip="string"                 VerticalAlign="NotSet|Top|Middle|Bottom"                 Visible="True|False"                 Width="size" >                         <asp:TableCell                             AccessKey="string"                             AssociatedHeaderCellID="string"                             BackColor="color name|#dddddd"                             BorderColor="color name|#dddddd"                             BorderStyle="NotSet|None|Dotted|Dashed|                                 Solid|Double|Groove|Ridge|Inset|                                 Outset"                             BorderWidth="size"                             ColumnSpan="integer"                             CssClass="string"                             Enabled="True|False"                             EnableTheming="True|False"                             EnableViewState="True|False"                             Font-Bold="True|False"                             Font-Italic="True|False"                             Font-Names="string"                             Font-Overline="True|False"                             Font-Size="string|Smaller|Larger|                                 XX-Small|X-Small|Small|Medium|Large|                                 X-Large|XX-Large"                             Font-Strikeout="True|False"                             Font-Underline="True|False"                             ForeColor="color name|#dddddd"                             Height="size"                             HorizontalAlign="NotSet|Left|Center|                                 Right|Justify"                             ID="string"                             OnDataBinding="DataBinding event handler"                             OnDisposed="Disposed event handler"                             OnInit="Init event handler"                             OnLoad="Load event handler"                             OnPreRender="PreRender event handler"                             OnUnload="Unload event handler"                             RowSpan="integer"                             runat="server"                             SkinID="string"                             Style="string"                             TabIndex="integer"                             Text="string"                             ToolTip="string"                             VerticalAlign="NotSet|Top|Middle|Bottom"                             Visible="True|False"                             Width="size"                             Wrap="True|False"                         />                         <asp:TableHeaderCell                             AbbreviatedText="string"                             AccessKey="string"                             AssociatedHeaderCellID="string"                             BackColor="color name|#dddddd"                             BorderColor="color name|#dddddd"                             BorderStyle="NotSet|None|Dotted|Dashed|                                 Solid|Double|Groove|Ridge|Inset|                                 Outset"                             BorderWidth="size"                             CategoryText="string"                             ColumnSpan="integer"                             CssClass="string"                             Enabled="True|False"                             EnableTheming="True|False"                             EnableViewState="True|False"                             Font-Bold="True|False"                             Font-Italic="True|False"                             Font-Names="string"                             Font-Overline="True|False"                             Font-Size="string|Smaller|Larger|                                 XX-Small|X-Small|Small|Medium|Large|                                 X-Large|XX-Large"                             Font-Strikeout="True|False"                             Font-Underline="True|False"                             ForeColor="color name|#dddddd"                             Height="size"                             HorizontalAlign="NotSet|Left|Center|                                 Right|Justify"                             ID="string"                             OnDataBinding="DataBinding event handler"                             OnDisposed="Disposed event handler"                             OnInit="Init event handler"                             OnLoad="Load event handler"                             OnPreRender="PreRender event handler"                             OnUnload="Unload event handler"                             RowSpan="integer"                             runat="server"                             Scope="NotSet|Row|Column"                             SkinID="string"                             Style="string"                             TabIndex="integer"                             Text="string"                             ToolTip="string"                             VerticalAlign="NotSet|Top|Middle|Bottom"                                                         Visible="True|False"                             Width="size"                                                         Wrap="True|False"                                                 />                         </asp:TableRow> </asp:Table>

備註

Table 類別可以讓您建置 HTML 表格並指定其特性。表格可以在設計階段使用靜態內容建置，但是 Table 控制項通常都使用動態內容以程式設計的方式建置。

注意事項：

以程式的方式對資料表資料列或儲存格加入或修改的內容，將無法持續 (Persist) 回傳至伺服器。表格的列和儲存格都是它們自己的控制項，而不是 Table 控制項的屬性。對資料列和儲存格的變更，必須在每次回傳至伺服器後重新建構。如果預期會有許多修改，請使用 DataList 或 DataGrid 控制項，而非 Table 控制項。

每個 Table 控制項，都由儲存在控制項之 Rows 集合中的列 (以 HtmlTableRow 類別的執行個體所表示) 所構成。每一列都由儲存在每個 TableRow 之 Cells 集合中的儲存格 (以 HtmlTableCell 類別的執行個體表示) 所構成。

只要設定 BackImageUrl 屬性，即可在 Table 控制項的背景中顯示影像。根據預設，表格中項目的水平對齊並未設定。如果希望指定水平對齊，請設定 HorizontalAlignment 屬性。個別儲存格之間的間距是由 CellSpacing 屬性所控制。您可以設定 CellPadding 屬性，指定儲存格內容與儲存格框線之間的空間。若要顯示儲存格框線，請設定 GridLines 屬性。您可以顯示水平線、垂直線，或是兩者都顯示。

警告：

尚未顯示於 Table 控制項中的文字，便還未經過 HTML 編碼。這樣便可以在文字中的 HTML 標記內嵌入指令碼。如果控制項的值來自使用者輸入，請務必驗證值來協助防止安全性的弱點。

如需 Table Web 伺服器控制項之屬性和事件的詳細資訊，請參閱 Table 類別文件。

範例

下列程式碼範例示範如何在設計階段建立表格。此表格含有兩列，其中各含兩個儲存格。

注意事項：

下列程式碼範例使用單一檔案程式碼模型，若直接複製到程式碼後置檔案，可能無法正確運作。這個程式碼範例必須複製到 .aspx 副檔名的空文字檔中。如需 Web Form 的詳細資訊，請參閱 ASP.NET Web 網頁程式碼模型。

 
<%@ Page Language="VB" %>

<!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 runat="server">
    <title>Table Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Table example, constructed at design time</h3>
    <asp:Table id="Table1" runat="server"
        CellPadding="10" 
        GridLines="Both"
        HorizontalAlign="Center">
        <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>
    </asp:Table>

    </div>
    </form>
</body>
</html>

<%@ Page Language="C#" %>

<!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 runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Table example, constructed at design time</h3>
    <asp:Table id="Table1" runat="server"
        CellPadding="10" 
        GridLines="Both"
        HorizontalAlign="Center">
        <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>
    </asp:Table>

    </div>
    </form>
</body>
</html>

請參閱

參考

Table

TableCell Web 伺服器控制項宣告式語法

TableRow Web 伺服器控制項宣告式語法

其他資源

Web 伺服器控制項語法