Sintassi dichiarativa per il controllo server Web TableCell
Aggiornamento: novembre 2007
Rappresenta una cella in un controllo Table e consente di modificarla a livello di codice.
<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:TableCell>
Note
Un'istanza della classe TableCell rappresenta una cella in un controllo Table. Le celle di ogni riga vengono memorizzate nell'insieme Cells del controllo TableRow che rappresenta la riga. Utilizzando la proprietà Text, è possibile modificare il contenuto di una cella.
La classe consente di controllare la modalità di visualizzazione del contenuto della cella. L'impostazione delle proprietà HorizontalAlign e VerticalAlign consente di specificare rispettivamente l'allineamento orizzontale e verticale del contenuto della cella. È possibile utilizzare la proprietà Wrap per specificare se il contenuto della cella deve proseguire automaticamente nella riga successiva quando viene raggiunto il limite della cella.
Inoltre, nel controllo Table è possibile specificare il numero di righe o di colonne occupate da una cella. Le proprietà RowSpan e ColumnSpan controllano rispettivamente il numero di righe e di colonne utilizzate.
.gif "Nota di avviso") Attenzione: |
|---|
Il testo non viene codificato in formato HTML prima di essere visualizzato nel controllo TableCell. È pertanto possibile incorporare script all'interno dei tag HTML presenti nel testo. Se i valori del controllo provengono dall'input dell'utente, assicurarsi di convalidare tali valori per evitare problemi di protezione. |
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web TableCell, vedere la documentazione relativa alla classe TableCell.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come creare una tabella, aggiungervi elementi a livello di codice, quindi visualizzarla nella pagina Web. Si noti il modo in cui viene creata un'istanza dei controlli TableCell e vengono impostati i relativi valori di proprietà.
<%@ page language="VB" %>
<%@ Import Namespace="System.Drawing" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Private Sub Page_Load(ByVal sender As Object, ByVal 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 rowNum As Integer
For rowNum = 2 To 9
Dim tempRow As New TableRow()
Dim cellNum As Integer
For cellNum = 0 To 2
Dim tempCell As New TableCell()
tempCell.Text = _
String.Format("({0},{1})", rowNum, cellNum)
tempRow.Cells.Add(tempCell)
Next
Table1.Rows.Add(tempRow)
Next
' Apply the TableItemStyle to all rows in the table.
Dim rw As TableRow
For Each rw In Table1.Rows
Dim cel As TableCell
For Each cel In rw.Cells
cel.ApplyStyle(tableStyle)
Next
Next
' 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>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableCell Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h1>TableCell Example</h1>
<asp:table id="Table1" runat="server"
CellPadding="3" CellSpacing="3"
Gridlines="both">
<asp:TableRow>
<asp:TableCell Text="(0,0)" />
<asp:TableCell Text="(0,1)" />
<asp:TableCell Text="(0,2)" />
</asp:TableRow>
<asp:TableRow>
<asp:TableCell Text="(1,0)" />
<asp:TableCell Text="(1,1)" />
<asp:TableCell Text="(1,2)" />
</asp:TableRow>
</asp:table>
</div>
</form>
</body>
</html>
<%@ page language="C#" %>
<%@ Import Namespace="System.Drawing" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 rowNum = 2; rowNum < 10; rowNum++)
{
TableRow tempRow = new TableRow();
for (int cellNum = 0; cellNum < 3; cellNum++)
{
TableCell tempCell = new TableCell();
tempCell.Text =
String.Format("({0},{1})", rowNum, cellNum);
tempRow.Cells.Add(tempCell);
}
Table1.Rows.Add(tempRow);
}
// Apply the TableItemStyle to all rows in the table.
foreach (TableRow rw in Table1.Rows)
foreach (TableCell cel in rw.Cells)
cel.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>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableCell Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h1>TableCell Example</h1>
<asp:table id="Table1" runat="server"
CellPadding="3" CellSpacing="3"
Gridlines="both">
<asp:TableRow>
<asp:TableCell Text="(0,0)" />
<asp:TableCell Text="(0,1)" />
<asp:TableCell Text="(0,2)" />
</asp:TableRow>
<asp:TableRow>
<asp:TableCell Text="(1,0)" />
<asp:TableCell Text="(1,1)" />
<asp:TableCell Text="(1,2)" />
</asp:TableRow>
</asp:table>
</div>
</form>
</body>
</html>