Freigeben über

Deklarative Syntax des Table-Webserversteuerelements

Aktualisiert: November 2007

Mit diesem Steuerelement wird eine Tabelle deklariert, die sich programmgesteuert bearbeiten lässt.

<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>

Hinweise

Mit der Table-Klasse können Sie eine HTML-Tabelle erstellen und deren Eigenschaften angeben. Zur Entwurfszeit kann zwar eine Tabelle mit statischem Inhalt erstellt werden, das Table-Steuerelement wird jedoch in der Regel programmgesteuert mit dynamischem Inhalt erstellt.

Tipp

Programmgesteuerte Hinzufügungen oder Änderungen in einer Tabellenzeile oder -zelle bleiben nicht von einer Übermittlung an den Server zur nächsten erhalten. Tabellenzeilen und -zellen sind keine Eigenschaften des Table-Steuerelements, sondern eigenständige Steuerelemente. Änderungen an Tabellenzeilen oder ‑zellen müssen nach jeder Übermittlung an den Server rekonstruiert werden. Verwenden Sie bei bevorstehenden umfassenden Änderungen anstelle des Table-Steuerelements das DataList-Steuerelement oder das DataGrid-Steuerelement.

Jedes Table-Steuerelement besteht aus Zeilen (dargestellt durch Instanzen der HtmlTableRow-Klasse), die in der Rows-Auflistung des Steuerelements gespeichert sind. Jede Zeile besteht aus Zellen (dargestellt durch Instanzen der HtmlTableCell-Klasse), die in der Cells-Auflistung jeder TableRow gespeichert sind.

Sie können ein Bild im Hintergrund des Table-Steuerelements anzeigen, indem Sie die BackImageUrl-Eigenschaft festlegen. Standardmäßig ist die horizontale Ausrichtung der Elemente in der Tabelle nicht festgelegt. Um die horizontale Ausrichtung anzugeben, legen Sie die HorizontalAlignment-Eigenschaft fest. Die Abstände zwischen den einzelnen Zellen wird durch die CellSpacing-Eigenschaft angegeben. Sie können den Abstand zwischen dem Inhalt einer Zelle und dem Rahmen der Zelle angeben, indem Sie die CellPadding-Eigenschaft festlegen. Um die Zellrahmen anzuzeigen, legen Sie die GridLines-Eigenschaft fest. Sie können die horizontalen Linien, die vertikalen Linien oder beide anzeigen.

Warnung

Text wird erst dann HTML-codiert, wenn er im Table-Steuerelement angezeigt wird. Auf diese Weise können Skripts in HTML-Tags in den Text eingebunden werden. Wenn die Werte in diesem Steuerelement aus Benutzereingaben stammen, müssen die Werte unbedingt validiert werden, um die Sicherheit zu gewährleisten.

Ausführliche Informationen zu den Eigenschaften und Ereignissen von Table-Webserversteuerelementen finden Sie in der Dokumentation zur Table-Klasse.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie eine Tabelle zur Entwurfszeit erstellt wird. Die Tabelle enthält zwei Zeilen mit jeweils zwei Zellen.

Tipp

Das folgende Codebeispiel verwendet das Einzeldatei-Codemodell und funktioniert möglicherweise nicht korrekt, wenn es direkt in eine Code-Behind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung .aspx kopiert werden. Weitere Informationen über das Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ 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>

Siehe auch

Referenz

Table

Deklarative Syntax des TableCell-Webserversteuerelements

Deklarative Syntax des TableRow-Webserversteuerelements

Weitere Ressourcen

Syntax des Webserversteuerelements

  • Last updated on