TableCellCollection.AddRange(TableCell[]) Méthode

Définition

Ajoute les objets TableCell du tableau spécifié à la fin de la collection.

public:
 void AddRange(cli::array <System::Web::UI::WebControls::TableCell ^> ^ cells);
public void AddRange (System.Web.UI.WebControls.TableCell[] cells);
member this.AddRange : System.Web.UI.WebControls.TableCell[] -> unit
Public Sub AddRange (cells As TableCell())

Paramètres

cells
TableCell[]

Tableau contenant les objets TableCell à ajouter à la collection.

Exceptions

La valeur du paramètre cells est null.

Exemples

L’exemple suivant montre comment utiliser la AddRange méthode pour ajouter les TableCell objets d’un tableau à un TableCellCollection. Notez que dans l’exemple, la Cells propriété de TableRow est une instance de la TableCellCollection classe .

void Page_Load(Object sender, EventArgs e) 
{
    int numRows = 3;
    int numCells = 2;
    // Create 3 rows, each containing 2 cells.
    for(int rowNum = 0; rowNum < numRows; rowNum++) 
    {
        TableCell[] arrayOfTableRowCells = 
            new TableCell[numCells];
        TableRow tRow =  new TableRow();

        for (int cellNum = 0; cellNum < numCells; cellNum++)
        {
            TableCell tCell =  new TableCell();
            tCell.Text = 
                String.Format("[Row {0}, Cell {1}]", 
                    rowNum, cellNum);
            arrayOfTableRowCells[cellNum] = tCell;
        } 

        // Get 'TableCellCollection' associated 
        // with the 'TableRow'.
        TableCellCollection myTableCellCol = tRow.Cells;
        // Add a row of cells. 
        myTableCellCol.AddRange(arrayOfTableRowCells);
        Table1.Rows.Add(tRow);
    } 
}
Sub Page_Load(ByVal sender As Object, _
    ByVal e As EventArgs)

    Dim numRows As Integer = 3
    Dim numCells As Integer = 2
    ' Create 3 rows, each containing 2 cells.
    Dim rowNum As Integer
    For rowNum = 0 To numRows - 1
        Dim arrayOfTableRowCells(numCells - 1) As TableCell
        Dim rw As New TableRow()
        Dim cellNum As Integer
        For cellNum = 0 To numCells - 1
            Dim cel As New TableCell()
            cel.Text = _
                String.Format("[Row {0}, Cell {1}]", rowNum, cellNum)
            arrayOfTableRowCells(cellNum) = cel
        Next

        ' Get 'TableCellCollection' associated with the 'TableRow'.
        Dim myTableCellCol As TableCellCollection = rw.Cells
        ' Add a row of cells. 
        myTableCellCol.AddRange(arrayOfTableRowCells)
        Table1.Rows.Add(rw)
    Next
End Sub

Remarques

Utilisez la AddRange méthode pour ajouter les TableCell objets du tableau spécifié à la collection. Cette méthode est couramment utilisée lorsque vous construisez une ligne d’une table. Pour construire une ligne d’une table, créez d’abord un tableau d’objets TableCell pour représenter les cellules de la ligne. Ensuite, utilisez la AddRange méthode, en passant le tableau comme argument, pour ajouter les TableCell objets à la collection.

S’applique à

Voir aussi