TableCellCollection.AddRange-Methode

Artikel
08/20/2007

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Sub AddRange ( _
    cells As TableCell() _
)
'Usage
Dim instance As TableCellCollection
Dim cells As TableCell()

instance.AddRange(cells)

public void AddRange (
    TableCell[] cells
)

public:
void AddRange (
    array<TableCell^>^ cells
)

public void AddRange (
    TableCell[] cells
)

public function AddRange (
    cells : TableCell[]
)

Parameter

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

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der Wert des cells-Parameters ist NULL (Nothing in Visual Basic).

Hinweise

Mit der AddRange-Methode können Sie die TableCell-Objekte aus dem angegebenen Array an die Auflistung anfügen. Diese Methode wird häufig beim Erstellen einer Tabellenzeile verwendet. Zum Erstellen einer Tabellenzeile erstellen Sie zunächst ein Array von TableCell-Objekten, die die Zellen der Zeile darstellen. Mit der AddRange-Methode, der Sie das Array als Argument übergeben, fügen Sie der Auflistung anschließend die TableCell-Objekte hinzu.

Beispiel

Das folgende Beispiel veranschaulicht, wie die TableCell-Objekte aus einem Array mithilfe der AddRange-Methode einer TableCellCollection hinzugefügt werden. Beachten Sie, dass die Cells-Eigenschaft von TableRow in diesem Beispiel eine Instanz der TableCellCollection-Klasse ist.

      Sub Page_Load(sender As Object, e As EventArgs)
         Dim numRows As Integer = 3
         Dim numCells As Integer = 2
         ' Create 3 rows, each containing 2 cells.
         Dim i As Integer
         For i = 0 To numRows - 1
            Dim arrayOfTableRowCells(numCells-1) As TableCell
            Dim myTableRow As New TableRow()
            Dim j As Integer
         For j = 0 To numCells - 1
            Dim myTableCell As New TableCell()
            myTableCell.Text = "[Row " + i.ToString() + ", Cell " + j.ToString() + "]"
            arrayOfTableRowCells(j) = myTableCell
         Next j
      
            ' Get 'TableCellCollection' associated with the 'TableRow'.
            Dim myTableCellCol As TableCellCollection = myTableRow.Cells
            ' Add a row of cells. 
            myTableCellCol.AddRange(arrayOfTableRowCells)
            myTable.Rows.Add(myTableRow)
         Next i
End Sub 'Page_Load

void Page_Load(Object sender, EventArgs e)
{
   int numRows = 3;
   int numCells = 2;
   // Create 3 rows, each containing 2 cells.
   for (int i = 0; i < numRows; i++)
   {
      TableCell[] arrayOfTableRowCells = new TableCell[numCells];
      TableRow myTableRow = new TableRow();
      for (int j = 0; j < numCells; j++)
      {
         TableCell myTableCell = new TableCell();
         myTableCell.Text = "[Row " + i.ToString() + ", Cell " 
                            + j.ToString()+ "]";
         arrayOfTableRowCells[j] = myTableCell;
      }
      
      // Get 'TableCellCollection' associated with the 'TableRow'.
      TableCellCollection myTableCellCol = myTableRow.Cells;
      // Add a row of cells. 
      myTableCellCol.AddRange(arrayOfTableRowCells);
      myTable.Rows.Add(myTableRow);
   }
}

void Page_Load(Object sender, EventArgs e) 
{
    int numRows = 3;
    int numCells = 2;
    // Create 3 rows, each containing 2 cells.
    for(int i=0;i < numRows;i++) {
        TableCell arrayOfTableRowCells[] = new TableCell[numCells];
        TableRow myTableRow =  new TableRow();
        
        for(int j=0;j < numCells;j++) {
            TableCell myTableCell =  new TableCell();
            myTableCell.set_Text("[Row " + System.Convert.ToString(i) 
                + ", Cell " + System.Convert.ToString(j) + "]");
            arrayOfTableRowCells .set_Item( j , myTableCell );
        } 
      
        // Get 'TableCellCollection' associated with the 'TableRow'.
        TableCellCollection myTableCellCol = myTableRow.get_Cells();
        // Add a row of cells. 
        myTableCellCol.AddRange(arrayOfTableRowCells);
        myTable.get_Rows().Add(myTableRow);
    } 
} //Page_Load

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TableCellCollection-Klasse
TableCellCollection-Member
System.Web.UI.WebControls-Namespace
Add
AddAt

Weitere Ressourcen

Table-, TableRow- und TableCell-Webserver-Steuerelemente

Freigeben über