TableRowCollection.CopyTo Method
Copies the items from the TableRowCollection to the specified System.Array, starting with the specified index in the System.Array.
[Visual Basic] Public Overridable Sub CopyTo( _ ByVal array As Array, _ ByVal index As Integer _ ) Implements ICollection.CopyTo [C#] public virtual void CopyTo( Array array, int index ); [C++] public: virtual void CopyTo( Array* array, int index ); [JScript] public function CopyTo( array : Array, index : int );
Parameters
- array
- A zero-based System.Array that receives the copied items from the TableRowCollection.
- index
- The first position in the specified System.Array to receive copied contents.
Implements
Remarks
Use this method to copy the contents of the TableRowCollection into the specified System.Array, starting at the specified index.
Note The array parameter must be a zero-based System.Array.
Example
[Visual Basic, C#] The following example demonstrates how to use the CopyTo method to copy the items from the TableRowCollection into the specified array.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub Page_Load(sender As Object, e As EventArgs) Dim numrows As Integer = 5 Dim numcells As Integer = 6 Dim counter As Integer = 1 Dim a_row As New ArrayList() ' Create a table. Dim j As Integer For j = 0 To numrows - 1 Dim r As New TableRow() Dim i As Integer For i = 0 To numcells - 1 Dim c As New TableCell() c.Text = counter.ToString() r.Cells.Add(c) counter += 1 Next i Table1.Rows.Add(r) Next j End Sub Sub Button_Click(sender As Object, e As EventArgs) Dim row_counter As Integer = 0 Dim myRowArray(5) As TableRow Dim myCellArray(6) As TableCell ' Copy the Rows collection to an array. Table1.Rows.CopyTo(myRowArray, 0) Label1.Text = "The copied items from the table are: " ' Iterate through the TableRows in the array. Dim table_row As TableRow For Each table_row In myRowArray ' Copy the Cells collection of a row to an array. Table1.Rows(row_counter).Cells.CopyTo(myCellArray, 0) ' Iterate through the cell array and display its contents. Dim cell As TableCell For Each cell In myCellArray Label1.Text = Label1.Text + " " + cell.Text Next cell row_counter += 1 Next table_row End Sub </script> </head> <body> <h3>TableCellCollection Example</h3> <form runat=server> <asp:Table id="Table1" runat="server"/> <br><br> <center> <asp:Button id="Button1" Text="Copy Table to Array" OnClick="Button_Click" runat="server"/> <br><br> <asp:Label id="Label1" runat="server"/> </center> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void Page_Load(Object sender, EventArgs e) { int numrows = 5; int numcells = 6; int counter = 1; ArrayList a_row = new ArrayList(); // Create a table. for (int j=0; j<numrows; j++) { TableRow r = new TableRow(); for (int i=0; i<numcells; i++) { TableCell c = new TableCell(); c.Text=counter.ToString(); r.Cells.Add(c); counter++; } Table1.Rows.Add(r); } } void Button_Click(object sender, EventArgs e) { int row_counter = 0; TableRow[] myRowArray = new TableRow[5]; TableCell[] myCellArray = new TableCell[6]; // Copy the Rows collection to an array. Table1.Rows.CopyTo(myRowArray, 0); Label1.Text = "The copied items from the table are: "; // Iterate through the TableRows in the array. foreach (TableRow table_row in myRowArray) { // Copy the Cells collection of a row to an array. Table1.Rows[row_counter].Cells.CopyTo(myCellArray, 0); // Iterate through the cell array and display its contents. foreach (TableCell cell in myCellArray) { Label1.Text = Label1.Text + " " + cell.Text; } row_counter++; } } </script> </head> <body> <h3>TableCellCollection Example</h3> <form runat=server> <asp:Table id="Table1" runat="server"/> <br><br> <center> <asp:Button id="Button1" Text="Copy Table to Array" OnClick="Button_Click" runat="server"/> <br><br> <asp:Label id="Label1" runat="server"/> </center> </form> </body> </html>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
TableRowCollection Class | TableRowCollection Members | System.Web.UI.WebControls Namespace | System.Array