This documentation is archived and is not being maintained.

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

ICollection.CopyTo

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 Language Filter 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

Show: