TableCellCollection.AddRange(TableCell[]) Methode

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Voegt de TableCell objecten van de opgegeven matrix toe aan het einde van de verzameling.

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())

Parameters

cells
TableCell[]

De matrix die de TableCell objecten bevat die moeten worden toegevoegd aan de verzameling.

Uitzonderingen

ArgumentNullException

De waarde van de cells parameter is null.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de AddRange methode gebruikt om de TableCell objecten van een matrix toe te voegen aan een TableCellCollection. In het voorbeeld is de Cells eigenschap van de TableRow klasse een exemplaar van de TableCellCollection klasse.

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

Opmerkingen

Gebruik de AddRange methode om de TableCell objecten uit de opgegeven matrix toe te voegen aan de verzameling. Deze methode wordt vaak gebruikt wanneer u een rij van een tabel maakt. Als u een rij van een tabel wilt maken, maakt u eerst een matrix met TableCell objecten die de cellen van de rij vertegenwoordigen. Gebruik vervolgens de AddRange methode om de matrix als argument door te geven om de TableCell objecten toe te voegen aan de verzameling.

Van toepassing op

Zie ook