TableCellCollection.AddRange(TableCell[]) Méthode

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.

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

ArgumentNullException

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 est TableRow 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’un tableau, commencez par créer un tableau d’objets TableCell pour représenter les cellules de la ligne. Ensuite, utilisez la AddRange méthode, en passant le tableau en tant qu’argument, pour ajouter les TableCell objets à la collection.

S’applique à