HtmlTableCell-Klasse
Stellt das <td>-HTML-Element und das <th>-HTML-Element in einem HtmlTableRow-Objekt dar.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class HtmlTableCell
Inherits HtmlContainerControl
'Usage
Dim instance As HtmlTableCell
public class HtmlTableCell : HtmlContainerControl
public ref class HtmlTableCell : public HtmlContainerControl
public class HtmlTableCell extends HtmlContainerControl
public class HtmlTableCell extends HtmlContainerControl
Hinweise
Das <td>-Element stellt eine Datenzelle in einer Tabelle dar, während das <th>-Element eine Tabellenüberschriftenzelle darstellt. Verwenden Sie die HtmlTableCell-Klasse, um das <td>-HTML-Element und das <th>-HTML-Element in einem HtmlTableRow-Objekt programmgesteuert zu steuern.
Mit der HtmlTableCell-Klasse können Sie die Darstellung einer Zelle in einer Tabelle anpassen, indem Sie die Hintergrundfarbe, die Rahmenfarbe, die Höhe und die Breite angeben. Diese Attribute werden mithilfe der BgColor-Eigenschaft, der BorderColor-Eigenschaft, der Height-Eigenschaft und der Width-Eigenschaft festgelegt.
Sie können die Anzeige des Inhalts einer Zelle steuern, indem Sie die horizontale und vertikale Ausrichtung des Inhalts angeben. Außerdem können Sie angeben, ob der Inhalt automatisch in der nächsten Zeile fortgesetzt wird, wenn das Ende der Zelle erreicht ist. Die horizontale Ausrichtung wird durch die Align-Eigenschaft gesteuert, während die VAlign-Eigenschaft die vertikale Ausrichtung steuert. Die NoWrap-Eigenschaft gibt an, ob der Textumbruch deaktiviert ist.
Mit der ColSpan-Eigenschaft und der RowSpan-Eigenschaft können Sie die Anzahl der Spalten bzw. Zeilen bestimmen, die von einer Zelle belegt werden. Sie können z. B. eine Zelle erstellen, die zwei Spalten in einer Tabelle belegt, indem Sie die ColSpan-Eigenschaft auf 2 festlegen.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlTableCell finden Sie unter HtmlTableCell-Konstruktor.
Warnung
Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die u. U. böswillige Clientskripts enthalten können. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder anderen Code, bevor Sie sie in der Anwendung anzeigen. ASP.NET stellt ein Validierungsfeature für Eingabeanforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Validierungsserversteuerelemente werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.
| Thema | Position |
|---|---|
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird die Verwendung einer HtmlTableCell zum Ändern des Inhalts einer Zelle in einer Tabelle veranschaulicht. Beachten Sie, dass die Rows-Auflistung eines HtmlTable-Steuerelements eine Auflistung der Zeilen (HtmlTableRow-Objekte) in der Tabelle enthält. Die Cells-Auflistung eines HtmlTableRow-Objekts ist eine Auflistung der Zellen (HtmlTableCell-Objekte) in einer Zeile.
<%@ Page Language="VB" AutoEventWireup="True" %>
<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>
<html>
<head>
<title>HtmlTableCell</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
border="1"
bordercolor="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 type="button"
value="Change Table Contents"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<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>
<html>
<head>
<title>HtmlTableCell</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
border="1"
bordercolor="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 type="button"
value="Change Table Contents"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlContainerControl
System.Web.UI.HtmlControls.HtmlTableCell
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlTableCell-Member
System.Web.UI.HtmlControls-Namespace
HtmlTable-Klasse
HtmlTable.Rows-Eigenschaft
HtmlTableRow
Cells
Align
BgColor
BorderColor
ColSpan
Height
NoWrap
RowSpan
VAlign
Width