Deklarative Syntax des HtmlTableCell-Serversteuerelements
[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 <td>-HTML-Element und dem <th>-HTML-Element zugeordnet wird und die Bearbeitung einer Zelle in einer Tabelle ermöglicht.
<td|th
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"
>
CellContent
</td|/th>
Hinweise
Verwenden Sie die HtmlTableCell-Klasse, um das <td>-HTML-Element und das <th>-HTML-Element zu programmieren. Ein <td>-Element stellt eine Datenzelle dar, während das <th>-Element eine Überschriftenzelle darstellt. Beachten Sie, dass der Inhalt einer <th>-Zelle immer fett formatiert und zentriert wird.
Mit der HtmlTableCell-Klasse können Sie die Darstellung jeder einzelnen Zelle steuern. Sie können Hintergrundfarbe, Rahmenfarbe sowie Höhe und Breite der Zelle angeben, indem Sie jeweils die BgColor-Eigenschaft, die BorderColor-Eigenschaft, die Height-Eigenschaft und die Width-Eigenschaft festlegen.
Hinweis
Alle Zellen in einer Zeile haben dieselbe Höhe.Die höchste Zelle in einer Zeile bestimmte die Höhe für alle Zellen in der Zeile.
Die horizontale und die vertikale Ausrichtung des Inhalts der Zelle wird durch das Festlegen der Align-Eigenschaft und der VAlign-Eigenschaft gesteuert. Sie können auch angeben, ob der Text automatisch in die nächste Zeile in der Zelle umbrochen werden soll, indem Sie die NoWrap-Eigenschaft festlegen.
Mit der HtmlTableCell-Klasse können Sie Zellen verbinden, indem Sie die ColSpan-Eigenschaft und die RowSpan-Eigenschaft festlegen. Mithilfe der ColSpan-Eigenschaft können Sie festlegen, wie viele Spalten eine Zelle einnimmt, und mit der RowSpan-Eigenschaft legen Sie die Anzahl der Zeilen fest, die eine Zelle einnimmt.
Hinweis
Achten Sie beim Verbinden von Zellen darauf, dass alle Zeilen der Tabelle dieselbe Länge haben.Stellen Sie außerdem sicher, dass jede Spalte über dieselbe Höhe verfügt.Andernfalls wird die Tabelle u. U. nicht wie erwartet dargestellt.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung eines HtmlTableCell-Objekts, um den Inhalt einer Zelle im HtmlTable-Steuerelement zu ändern.
<%@ 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>HtmlTableCell Control</title>
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim i As Integer
Dim j As Integer
' Iterate through the rows of the table.
For i = 0 To Table1.Rows.Count - 1
' Iterate through the cells of a row.
For j = 0 To Table1.Rows(i).Cells.Count - 1
' Change the inner HTML of the cell.
Table1.Rows(i).Cells(j).InnerHtml = "Row " & i.ToString() _
& ", Column " & _
j.ToString()
Next j
Next i
End Sub
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
style="border-width:1; border-color:Black"
runat="server">
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
</tr>
<tr>
<td>
Cell 3
</td>
<td>
Cell 4
</td>
</tr>
</table>
<br /><br />
<input id="Button1" type="button"
value="Change Table Contents"
onserverclick="Button_Click"
runat="server"/>
</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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTableCell Control</title>
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
// Iterate through the rows of the table.
for (int i=0; i<=Table1.Rows.Count - 1; i++)
{
// Iterate through the cells of a row.
for (int j=0; j<=Table1.Rows[i].Cells.Count - 1; j++)
{
// Change the inner HTML of the cell.
Table1.Rows[i].Cells[j].InnerHtml = "Row " + i.ToString() +
", Column " +
j.ToString();
}
}
}
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
style="border-width:1; border-color:Black"
runat="server">
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
</tr>
<tr>
<td>
Cell 3
</td>
<td>
Cell 4
</td>
</tr>
</table>
<br /><br />
<input id="Button1" type="button"
value="Change Table Contents"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>