TableCell-Klasse
Stellt eine Zelle in einem Table-Steuerelement dar.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<BindableAttribute(False)> _
Public Class TableCell
Inherits WebControl
'Usage
Dim instance As TableCell
[BindableAttribute(false)]
public class TableCell : WebControl
[BindableAttribute(false)]
public ref class TableCell : public WebControl
/** @attribute BindableAttribute(false) */
public class TableCell extends WebControl
BindableAttribute(false)
public class TableCell extends WebControl
Hinweise
Die TableCell-Klasse stellt eine Zelle in einem Table-Steuerelement dar. Mithilfe der Text-Eigenschaft können Sie den Inhalt der Zelle angeben oder bestimmen.
Mithilfe der TableCell-Klasse können Sie steuern, wie der Inhalt der Zelle angezeigt wird. Die Ausrichtung des Zelleninhalts wird durch Festlegen der HorizontalAlign-Eigenschaft und der VerticalAlign-Eigenschaft angegeben. Mithilfe der Wrap-Eigenschaft können Sie angeben, ob der Zelleninhalt in der Zelle umbrochen werden soll.
Sie können auch angeben, wie viele Zeilen oder Spalten eine einzelne Zelle in der Tabelle einnimmt, die durch ein Table-Steuerelement dargestellt ist. Die RowSpan-Eigenschaft und die ColumnSpan-Eigenschaft steuern die Anzahl der verwendeten Zeilen und Spalten.
Warnung
Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die u. U. bösartige 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 Feature zur Anfragevalidierung von Eingaben bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Serversteuerelemente zur Validierung werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Sichern von Standardsteuerelementen, Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen und Überprüfen der Benutzereingabe in ASP.NET-Webseiten.
Thema | Position |
---|---|
Gewusst wie: Anpassen einzelner Tage in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
Gewusst wie: Dynamisches Hinzufügen von Zeilen und Zellen zu einem Table-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
Gewusst wie: Anpassen einzelner Tage in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
Gewusst wie: Dynamisches Hinzufügen von Zeilen und Zellen zu einem Table-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
Gewusst wie: Anpassen einzelner Tage in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen |
Gewusst wie: Dynamisches Hinzufügen von Zeilen und Zellen zu einem Table-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie eine Tabelle erstellt werden kann, wie der Tabelle programmgesteuert Elemente hinzugefügt werden können und wie die Tabelle auf einer Webseite angezeigt werden kann. Beachten Sie, wie TableCell-Steuerelemente instanziiert und ihre Eigenschaftenwerte festgelegt werden.
Hinweis
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.
<%@ Page language="VB" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>
<html>
<head>
<script runat="server">
Private Sub Page_Load(sender As Object, e As System.EventArgs)
' Create a TableItemStyle object that can be
' set as the default style for all cells
' in the table.
Dim tableStyle As New TableItemStyle()
tableStyle.HorizontalAlign = HorizontalAlign.Center
tableStyle.VerticalAlign = VerticalAlign.Middle
tableStyle.Width = Unit.Pixel(100)
' Create more rows for the table.
Dim i As Integer
For i = 2 To 9
Dim tempRow As New TableRow()
Dim j As Integer
For j = 0 To 2
Dim tempCell As New TableCell()
tempCell.Text = "(" & i & "," & j & ")"
tempRow.Cells.Add(tempCell)
Next j
Table1.Rows.Add(tempRow)
Next i
' Apply the TableItemStyle to all rows in the table.
Dim r As TableRow
For Each r In Table1.Rows
Dim c As TableCell
For Each c In r.Cells
c.ApplyStyle(tableStyle)
Next c
Next r
' Create a header for the table.
Dim header As New TableHeaderCell()
header.RowSpan = 1
header.ColumnSpan = 3
header.Text = "Table of (x,y) Values"
header.Font.Bold = true
header.BackColor = Color.Gray
header.HorizontalAlign = HorizontalAlign.Center
header.VerticalAlign = VerticalAlign.Middle
' Add the header to a new row.
Dim headerRow As New TableRow()
headerRow.Cells.Add(header)
' Add the header row to the table.
Table1.Rows.AddAt(0, headerRow)
End Sub
</script>
</head>
<body>
<form runat="server">
<h1>TableCell Example</h1>
<asp:table id="Table1" runat="server" CellPadding="3" CellSpacing="3">
<asp:TableRow>
<asp:TableCell Text="(0,0)"></asp:TableCell>
<asp:TableCell Text="(0,1)"></asp:TableCell>
<asp:TableCell Text="(0,2)"></asp:TableCell>
</asp:TableRow>
<asp:TableRow>
<asp:TableCell Text="(1,0)"></asp:TableCell>
<asp:TableCell Text="(1,1)"></asp:TableCell>
<asp:TableCell Text="(1,2)"></asp:TableCell>
</asp:TableRow>
</asp:table>
</form>
</body>
</html>
<%@ Page language="C#" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>
<html>
<head>
<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
// Create a TableItemStyle object that can be
// set as the default style for all cells
// in the table.
TableItemStyle tableStyle = new TableItemStyle();
tableStyle.HorizontalAlign = HorizontalAlign.Center;
tableStyle.VerticalAlign = VerticalAlign.Middle;
tableStyle.Width = Unit.Pixel(100);
// Create more rows for the table.
for (int i = 2; i < 10; i++)
{
TableRow tempRow = new TableRow();
for (int j = 0; j < 3; j++)
{
TableCell tempCell = new TableCell();
tempCell.Text = "(" + i + "," + j + ")";
tempRow.Cells.Add(tempCell);
}
Table1.Rows.Add(tempRow);
}
// Apply the TableItemStyle to all rows in the table.
foreach (TableRow r in Table1.Rows)
foreach (TableCell c in r.Cells)
c.ApplyStyle(tableStyle);
// Create a header for the table.
TableHeaderCell header = new TableHeaderCell();
header.RowSpan = 1;
header.ColumnSpan = 3;
header.Text = "Table of (x,y) Values";
header.Font.Bold = true;
header.BackColor = Color.Gray;
header.HorizontalAlign = HorizontalAlign.Center;
header.VerticalAlign = VerticalAlign.Middle;
// Add the header to a new row.
TableRow headerRow = new TableRow();
headerRow.Cells.Add(header);
// Add the header row to the table.
Table1.Rows.AddAt(0, headerRow);
}
</script>
</head>
<body>
<form runat="server">
<h1>TableCell Example</h1>
<asp:table id="Table1" runat="server" CellPadding="3" CellSpacing="3">
<asp:TableRow>
<asp:TableCell Text="(0,0)"></asp:TableCell>
<asp:TableCell Text="(0,1)"></asp:TableCell>
<asp:TableCell Text="(0,2)"></asp:TableCell>
</asp:TableRow>
<asp:TableRow>
<asp:TableCell Text="(1,0)"></asp:TableCell>
<asp:TableCell Text="(1,1)"></asp:TableCell>
<asp:TableCell Text="(1,2)"></asp:TableCell>
</asp:TableRow>
</asp:table>
</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.WebControls.WebControl
System.Web.UI.WebControls.TableCell
System.Web.UI.WebControls.DataControlFieldCell
System.Web.UI.WebControls.TableHeaderCell
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
TableCell-Member
System.Web.UI.WebControls-Namespace
Table-Klasse
Text
HorizontalAlign
VerticalAlign
Wrap
RowSpan
ColumnSpan
Weitere Ressourcen
Table-, TableRow- und TableCell-Webserver-Steuerelemente
Sichern von Standardsteuerelementen
Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen
Überprüfen der Benutzereingabe in ASP.NET-Webseiten