.NET Framework Class Library TableCellCollection Class

Inheritance Hierarchy
Namespace:
System.Web.UI.WebControls
Assembly:
System.Web (in System.Web.dll)

Syntax
Public NotInheritable Class TableCellCollection _
Implements IList, ICollection, IEnumerable
public sealed class TableCellCollection : IList,
ICollection, IEnumerable
public ref class TableCellCollection sealed : IList,
ICollection, IEnumerable
[<Sealed>]
type TableCellCollection =
class
interface IList
interface ICollection
interface IEnumerable
end
The TableCellCollection type exposes the following members.

Methods

Extension Methods

Explicit Interface Implementations

Remarks
Use this class to programmatically manage a collection of TableCell objects that make up a row in a Table control. This class is commonly used to add or remove cells from a row in a Table control. Note |
|---|
A Table control contains a Rows collection that represents a collection of TableRow objects. Each TableRow represents an individual row in the table and contains a Cells collection that represents a collection of TableCell objects. These TableCell objects represent the individual cells in the table. To get an individual cell, you must first get a TableRow from the Rows collection of a Table control. You can then get a TableCell from the Cells collection of the TableRow. |

Examples
The following example demonstrates how to programmatically fill a Table control. TableCell objects, which represent individual cells, are added to TableRow objects, which represent the individual rows, through the Cells property.
<%@ Page Language="VB" %>
<!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(sender As Object, e As EventArgs)
' Generate rows and cells.
Dim numrows As Integer = 4
Dim numcells As Integer = 6
Dim counter As Integer = 1
Dim rowNum As Integer
Dim cellNum As Integer
For rowNum = 0 To numrows - 1
Dim rw As New TableRow()
For cellNum = 0 To numcells - 1
Dim cel As New TableCell()
cel.Text = counter.ToString()
counter += 1
rw.Cells.Add(cel)
Next
Table1.Rows.Add(rw)
Next
End Sub
Private Sub Button_Click_Coord(sender As Object, e As EventArgs)
Dim rowNum As Integer
Dim cellNum As Integer
Dim rowCount As Integer
For rowCount = 0 To Table1.Rows.Count - 1
For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1
Table1.Rows(rowNum).Cells(cellNum).Text = _
String.Format("(Row{0}, Cell{1})", rowNum, cellNum)
Next
Next
End Sub
Private Sub Button_Click_Number(sender As Object, e As EventArgs)
Dim counter As Integer = 1
Dim rowNum As Integer
Dim cellNum As Integer
For rowNum = 0 To Table1.Rows.Count - 1
For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1
Table1.Rows(rowNum).Cells(cellNum).Text = _
counter.ToString()
counter += 1
Next
Next
End Sub
</script>
<html >
<head runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1"
runat="server"/>
<br />
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</div>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<!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, EventArgs e)
{
// Generate rows and cells.
int numrows = 4;
int numcells = 6;
int counter = 1;
for (int rowNum = 0; rowNum < numrows; rowNum++)
{
TableRow rw = new TableRow();
for (int cellNum = 0; cellNum < numcells; cellNum++)
{
TableCell cel = new TableCell();
cel.Text=counter.ToString();
counter++;
rw.Cells.Add(cel);
}
Table1.Rows.Add(rw);
}
}
private void Button_Click_Coord(object sender, EventArgs e)
{
for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++)
{
for (int cellNum = 0; cellNum <
Table1.Rows[rowNum].Cells.Count; cellNum++)
{
Table1.Rows[rowNum].Cells[cellNum].Text =
String.Format("(Row{0}, Cell{1})", rowNum, cellNum);
}
}
}
private void Button_Click_Number(object sender, EventArgs e)
{
int counter = 1;
for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++)
{
for (int cellNum = 0; cellNum <
Table1.Rows[rowNum].Cells.Count; cellNum++)
{
Table1.Rows[rowNum].Cells[cellNum].Text =
counter.ToString();
counter++;
}
}
}
</script>
<html >
<head runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1"
runat="server"/>
<br />
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</div>
</form>
</body>
</html>

Version Information
.NET FrameworkSupported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Thread Safety
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also
ReferenceTableCellCollection Other Resources
|
Bibliothèque de classes .NET Framework TableCellCollection, classe

Hiérarchie d'héritage
Espace de noms :
System.Web.UI.WebControls
Assembly :
System.Web (dans System.Web.dll)

Syntaxe
Public NotInheritable Class TableCellCollection _
Implements IList, ICollection, IEnumerable
public sealed class TableCellCollection : IList,
ICollection, IEnumerable
public ref class TableCellCollection sealed : IList,
ICollection, IEnumerable
[<Sealed>]
type TableCellCollection =
class
interface IList
interface ICollection
interface IEnumerable
end
Le type TableCellCollection expose les membres suivants.

Méthodes

Méthodes d'extension

Implémentations d'interface explicite

Notes
Utilisez cette classe pour manager par programme une collection d'objets TableCell formant une ligne dans un contrôle Table. Cette classe est généralement utilisée pour ajouter des cellules à une ligne d'un contrôle Table ou en supprimer. Remarque |
|---|
Un contrôle Table contient une collection Rows représentant une collection d'objets TableRow. Chaque TableRow représente une ligne individuelle dans le tableau et contient une collection Cells qui représente une collection d'objets TableCell. Ces objets TableCell représentent les cellules individuelles du tableau. Pour obtenir une cellule individuelle, commencez par obtenir un objet TableRow à partir de la collection Rows d'un contrôle Table. Vous pouvez ensuite obtenir un objet TableCell à partir de la collection Cells de l'objet TableRow. |

Exemples
L'exemple suivant montre comment remplir un contrôle Table par programmation. Les objets TableCell qui représentent des cellules individuelles sont ajoutés aux objets TableRow, qui représentent des lignes individuelles via la propriété Cells.
<%@ Page Language="VB" %>
<!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(sender As Object, e As EventArgs)
' Generate rows and cells.
Dim numrows As Integer = 4
Dim numcells As Integer = 6
Dim counter As Integer = 1
Dim rowNum As Integer
Dim cellNum As Integer
For rowNum = 0 To numrows - 1
Dim rw As New TableRow()
For cellNum = 0 To numcells - 1
Dim cel As New TableCell()
cel.Text = counter.ToString()
counter += 1
rw.Cells.Add(cel)
Next
Table1.Rows.Add(rw)
Next
End Sub
Private Sub Button_Click_Coord(sender As Object, e As EventArgs)
Dim rowNum As Integer
Dim cellNum As Integer
Dim rowCount As Integer
For rowCount = 0 To Table1.Rows.Count - 1
For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1
Table1.Rows(rowNum).Cells(cellNum).Text = _
String.Format("(Row{0}, Cell{1})", rowNum, cellNum)
Next
Next
End Sub
Private Sub Button_Click_Number(sender As Object, e As EventArgs)
Dim counter As Integer = 1
Dim rowNum As Integer
Dim cellNum As Integer
For rowNum = 0 To Table1.Rows.Count - 1
For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1
Table1.Rows(rowNum).Cells(cellNum).Text = _
counter.ToString()
counter += 1
Next
Next
End Sub
</script>
<html >
<head runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1"
runat="server"/>
<br />
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</div>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<!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, EventArgs e)
{
// Generate rows and cells.
int numrows = 4;
int numcells = 6;
int counter = 1;
for (int rowNum = 0; rowNum < numrows; rowNum++)
{
TableRow rw = new TableRow();
for (int cellNum = 0; cellNum < numcells; cellNum++)
{
TableCell cel = new TableCell();
cel.Text=counter.ToString();
counter++;
rw.Cells.Add(cel);
}
Table1.Rows.Add(rw);
}
}
private void Button_Click_Coord(object sender, EventArgs e)
{
for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++)
{
for (int cellNum = 0; cellNum <
Table1.Rows[rowNum].Cells.Count; cellNum++)
{
Table1.Rows[rowNum].Cells[cellNum].Text =
String.Format("(Row{0}, Cell{1})", rowNum, cellNum);
}
}
}
private void Button_Click_Number(object sender, EventArgs e)
{
int counter = 1;
for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++)
{
for (int cellNum = 0; cellNum <
Table1.Rows[rowNum].Cells.Count; cellNum++)
{
Table1.Rows[rowNum].Cells[cellNum].Text =
counter.ToString();
counter++;
}
}
}
</script>
<html >
<head runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1"
runat="server"/>
<br />
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</div>
</form>
</body>
</html>

Informations de version
.NET FrameworkPris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Plateformes
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Sécurité des threads
Tous les membres static ( Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi
RéférenceTableCellCollection Autres ressources
|