TableCellCollection Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Encapsule une collection d’objets TableHeaderCell et TableCell qui constituent une ligne dans un contrôle Table. Cette classe ne peut pas être héritée.

public ref class TableCellCollection sealed : System::Collections::IList

public sealed class TableCellCollection : System.Collections.IList

type TableCellCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public NotInheritable Class TableCellCollection
Implements IList

Héritage: Object
TableCellCollection

Implémente: ICollection IEnumerable IList

Exemples

L’exemple suivant montre comment remplir par programmation un Table contrôle. TableCell les objets, qui représentent des cellules individuelles, sont ajoutés aux TableRow objets, qui représentent les lignes individuelles, via la Cells propriété.

<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<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="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 xmlns="http://www.w3.org/1999/xhtml" >
<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>

Remarques

Utilisez cette classe pour gérer par programmation une collection d’objets TableCell qui composent une ligne dans un Table contrôle. Cette classe est couramment utilisée pour ajouter ou supprimer des cellules d’une ligne dans un Table contrôle.

Notes

Un Table contrôle contient une Rows collection qui représente une collection d’objets TableRow . Chacune TableRow représente une ligne individuelle dans la table et contient une Cells collection qui représente une collection d’objets TableCell . Ces TableCell objets représentent les cellules individuelles du tableau. Pour obtenir une cellule individuelle, vous devez d’abord obtenir une TableRow à partir de la Rows collection d’un Table contrôle. Vous pouvez ensuite obtenir une à TableCell partir de la Cells collection du TableRow.

Propriétés

Count	Obtient le nombre d'objets TableCell dans la TableCellCollection.
IsReadOnly	Obtient une valeur indiquant si TableCellCollection est en lecture seule.
IsSynchronized	Obtient une valeur qui indique si l'accès à la TableCellCollection est synchronisé (thread-safe).
Item[Int32]	Obtient un objet TableCell à partir du TableCellCollection à l'index spécifié.
SyncRoot	Obtient l'objet pouvant permettre de synchroniser l'accès à TableCellCollection.

Méthodes

Add(TableCell)	Ajoute le TableCell spécifié à la fin de TableCellCollection.
AddAt(Int32, TableCell)	Ajoute le TableCell spécifié à TableCellCollection à l'emplacement d'index spécifié.
AddRange(TableCell[])	Ajoute les objets TableCell du tableau spécifié à la fin de la collection.
Clear()	Supprime tous les objets TableCell de TableCellCollection.
CopyTo(Array, Int32)	Copie les éléments de TableCellCollection dans le Array spécifié, à commencer par l'index spécifié dans Array.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetCellIndex(TableCell)	Retourne une valeur représentant l'index du TableCell spécifié à partir de TableCellCollection.
GetEnumerator()	Retourne un objet implémentant IEnumerator qui contient tous les objets TableCell dans TableCellCollection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(TableCell)	Supprime le TableCell spécifié du TableCellCollection.
RemoveAt(Int32)	Supprime TableCell de TableCellCollection à l'index spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IList.Add(Object)	Ajoute un objet à la collection.
IList.Contains(Object)	Détermine si la collection contient l'objet spécifié.
IList.IndexOf(Object)	Recherche l'objet spécifié et retourne l'index de base zéro de la première occurrence de la collection.
IList.Insert(Int32, Object)	Insère un objet dans la collection à l'index spécifié.
IList.IsFixedSize	Pour obtenir une description de ce membre, consultez IsFixedSize.
IList.Item[Int32]	Pour obtenir une description de ce membre, consultez Item[Int32].
IList.Remove(Object)	Supprime un objet de la collection.

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à