TableCellCollection.AddRange(TableCell[]) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt die TableCell-Objekte aus dem angegebenen Array an das Ende der Auflistung an.

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

Parameter

cells: TableCell[]

Das Array mit den TableCell-Objekten, die der Auflistung hinzugefügt werden sollen.

Ausnahmen

ArgumentNullException

Der Wert des cells-Parameters ist null.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die AddRange -Methode verwendet wird, um die TableCell -Objekte aus einem Array zu einem TableCellCollectionhinzuzufügen. Beachten Sie, dass im Beispiel die Cells -Eigenschaft von TableRow eine Instanz der TableCellCollection -Klasse ist.

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

Hinweise

Verwenden Sie die AddRange -Methode, um die TableCell Objekte aus dem angegebenen Array an die Auflistung anzufügen. Diese Methode wird häufig verwendet, wenn Sie eine Zeile einer Tabelle erstellen. Um eine Zeile einer Tabelle zu erstellen, erstellen Sie zuerst ein Array von TableCell Objekten, die die Zellen der Zeile darstellen. Als Nächstes verwenden Sie die AddRange -Methode, und übergeben Sie das Array als Argument, um die TableCell -Objekte der Auflistung hinzuzufügen.

Gilt für: