Deklarative Syntax des HtmlTable-Serversteuerelements

Artikel
05/27/2012

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Erstellt ein serverseitiges Steuerelement, das dem <table>-HTML-Element zugeordnet wird und die Erstellung einer Tabelle ermöglicht.

<table
    EnableViewState="False|True"
    Id="string"
    Visible="False|True"
    OnDataBinding="OnDataBinding event handler"
    OnDisposed="OnDisposed event handler"
    OnInit="OnInit event handler"
    OnLoad="OnLoad event handler"
    OnPreRender="OnPreRender event handler"
    OnUnload="OnUnload event handler"
    runat="server"
    >

   <tr>
      <td></td>
   </tr>

</table>

Hinweise

Verwenden Sie das HtmlTable-Steuerelement, um das <table>-HTML-Element zu programmieren. Ein HtmlTable-Steuerelement besteht aus Zeilen, die durch HtmlTableRow-Objekte

dargestellt werden und in der Rows-Auflistung einer Tabelle gespeichert sind. Jede Zeile besteht aus Zellen, die durch HtmlTableCell-Objekte dargestellt werden und in der Cells-Auflistung einer Zeile gespeichert sind.

Deklarieren Sie zum Erstellen einer Tabelle zunächst ein HtmlTable-Steuerelement in dem Formular auf der Seite. Platzieren Sie anschließend für jede gewünschte Tabellenzeile ein HtmlTableRow-Objekt zwischen dem Start- und dem Endtag des HtmlTable-Steuerelements. Nachdem Sie die Zeilen der Tabelle definiert haben, deklarieren Sie HtmlTableCell-Objektezwischen dem Start- und dem Endtag jedes HtmlTableRow-Objekts, um die Zellen der Zeile zu erstellen.

Hinweis

Stellen Sie sicher, dass jede Zeile und jede Spalte die korrekte Anzahl von Zellen enthält. Andernfalls wird die Tabelle möglicherweise nicht wie erwartet angezeigt.Grundsätzlich sollte jede Zeile die gleiche Anzahl an Zellen enthalten.Entsprechend sollte jede Spalte die gleiche Anzahl an Zellen aufweisen.Wenn Sie Zellen verbinden, sollte jede Zeile die gleiche Breite und jede Spalte die gleiche Höhe haben.

Mit dem HtmlTable-Steuerelement können Sie das Erscheinungsbild einer Tabelle anpassen. Sie können Hintergrundfarbe, Rahmenstärke, Rahmenfarbe sowie Höhe und Breite der Tabelle angeben, indem Sie jeweils die BgColor-Eigenschaft, die Border-Eigenschaft, die BorderColor-Eigenschaft, die Height-Eigenschaft und die Width-Eigenschaft festlegen. Sie können ferner die Abstände zwischen den Zellen sowie die Abstände zwischen Zelleninhalt und Zellenrahmen steuern, indem Sie die CellSpacing-Eigenschaft und die CellPadding-Eigenschaft festlegen.

Beispiel

Im folgenden Beispiel werden Tabellenzeilen und -zellen generiert, basierend auf der Auswahl des Benutzers in zwei HtmlSelect-Steuerelementen. Bei jedem Laden der Seite überprüft der Code, welche Werte der Benutzer in den HtmlSelect-Steuerelementen ausgewählt hat. Basierend auf diesen Werten wird die Anzahl der Zeilen und Spalten im HtmlTable-Steuerelement dynamisch generiert. Erstellen Sie zum Konstruieren einer Tabelle die Zeilen der Tabelle, die durch HtmlTableRow-Objekte dargestellt werden, und fügen Sie diese der Rows-Auflistung des HtmlTable-Steuerelements hinzu. Erstellen Sie zum Konstruieren der Zeilen die Zellen der Zeile, die durch HtmlTableCell-Objekte dargestellt werden, und fügen Sie diese der Cells-Auflistung der HtmlTableRow hinzu.

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

<script runat="server">
    Sub Page_Load(sender As Object, e As EventArgs)
        Dim row As Integer = 0
        ' Generate rows and cells.
        Dim numrows As Integer = Convert.ToInt32(Select1.Value)
        Dim numcells As Integer = Convert.ToInt32(Select2.Value)
        Dim j As Integer

        For j = 0 To numrows - 1
            Dim r As New HtmlTableRow()
            ' Set bgcolor on alternating rows.
            If row Mod 2 = 1 Then
                r.BgColor = "Gainsboro"
            End If
            row += 1

            Dim i As Integer
            For i = 0 To numcells - 1
               Dim c As New HtmlTableCell()
               c.Controls.Add(New _
                   LiteralControl("row " & j.ToString() & _
                   ", cell " & i.ToString()))
               r.Cells.Add(c)
            Next i
            Table1.Rows.Add(r)
         Next j
      End Sub 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HtmlTable Control</title>
</head>
<body>  
<form id="Form1" runat="server">
   <div>

   <h3>HtmlTable Example</h3>

      <br />
      <table id="Table1"  cellspacing="0" runat="server"
         style="border-width:1; border-color: Black; padding: 5"
             /> 
      <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>
      <br />
      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>
      <input id="Submit1" type="submit" 
         value="Generate Table" runat="server" />

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

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

<script runat="server">
      void Page_Load(Object sender, EventArgs e) 
      {
         int row = 0;
         // Generate rows and cells.
         int numrows = Convert.ToInt32(Select1.Value);
         int numcells = Convert.ToInt32(Select2.Value);

         for (int j = 0; j < numrows; j++) 
         {
            HtmlTableRow r = new HtmlTableRow();
            // Set bgcolor on alternating rows.
            if (row%2 == 1)
               r.BgColor="Gainsboro";
            row++;

            for (int i = 0; i < numcells; i++) 
            {
               HtmlTableCell c = new HtmlTableCell();
               c.Controls.Add(new LiteralControl("row " + j.ToString() +
                    ", cell " + i.ToString()));
               r.Cells.Add(c);
            }
            Table1.Rows.Add(r);
         }
      }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>HtmlTable Control</title>
</head>
<body>  
<form id="Form1" runat="server">
   <div>

   <h3>HtmlTable Example</h3>

   <table id="Table1" 
      style="border-width:1; border-color:Black; padding:5"
      cellspacing="0" runat="server" /> 
      <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>
      <br />
      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>
      <input id="Submit1" type="submit" 
         value="Generate Table" runat="server" />

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