TableCellCollection.AddRange Method (TableCell())
Appends the TableCell objects from the specified array to the end of the collection.
Assembly: System.Web (in System.Web.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | The value of the cells parameter is null. |
Use the AddRange method to append the TableCell objects from the specified array to the collection. This method is commonly used when you are constructing a row of a table. To construct a row of a table, first create an array of TableCell objects to represent the cells of the row. Next, use the AddRange method, passing the array as an argument, to add the TableCell objects to the collection.
The following example demonstrates how to use the AddRange method to add the TableCell objects from an array to a TableCellCollection. Note that in the example, the Cells property of the TableRow is an instance of the TableCellCollection class.
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
Available since 1.1