This documentation is archived and is not being maintained.

TableCellCollection.CopyTo Method

Copies the items from the TableCellCollection 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 TableCellCollection.
index
The first index in the specified System.Array to receive the items.

Implements

ICollection.CopyTo

Remarks

Use this method to copy the contents of the TableCellCollection 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 TableCellCollection 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
            
            If Not IsPostBack Then
                
                ' Create a DropDownList for the number of rows.
                Dim k As Integer
                For k = 0 To numrows - 1
                    a_row.Add(k.ToString())
                Next k
                
                List1.DataSource = a_row
                List1.DataBind()
            End If 
        End Sub

        Sub Button_Click(sender As Object, e As EventArgs)
            
            Dim row As Integer = List1.SelectedIndex
            Dim myCellArray(6) As TableCell
            
            ' Copy the collection to an array.
            Table1.Rows(row).Cells.CopyTo(myCellArray, 0)
            
            Label1.Text = "The copied items from the selected row are: "
            
            ' Iterate through the array and display its contents.
            Dim cell As TableCell
            For Each cell In  myCellArray
            
                Label1.Text = Label1.Text & " " & cell.Text
                
            Next cell 
        End Sub
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1" 
            GridLines="Both" 
            HorizontalAlign="Center" 
            Font-Name="Verdana" 
            Font-Size="8pt" 
            CellPadding=15 
            CellSpacing=0 
            runat="server"/>
       <br><br>
       <center>
          Select a row:
          <br><br>
          Row:
          <asp:DropDownList id="List1" 
               runat="server"/>
 
          <br><br>
          <asp:Button id="Button1"
               Text="Copy Row 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);
          }
         
          if (!IsPostBack) 
          {
 
             // Create a DropDownList for the number of rows.
             for (int k=0; k<numrows; k++) 
             {
                a_row.Add(k.ToString());
             }
         
             List1.DataSource=a_row; 
             List1.DataBind();
        
          }
       }
 
    void Button_Click(object sender, EventArgs e) 
    {
 
       int row = List1.SelectedIndex;
       TableCell[] myCellArray = new TableCell[6];
 
       // Copy the collection to an array.
       Table1.Rows[row].Cells.CopyTo(myCellArray, 0);      
 
       Label1.Text = "The copied items from the selected row are: ";
 
       // Iterate through the array and display its contents.
       foreach (TableCell cell in myCellArray) 
       {
          
          Label1.Text = Label1.Text + " " + cell.Text;
 
       }
             
    }
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1" 
            GridLines="Both" 
            HorizontalAlign="Center" 
            Font-Name="Verdana" 
            Font-Size="8pt" 
            CellPadding=15 
            CellSpacing=0 
            runat="server"/>
       <br><br>
       <center>
          Select a row:
          <br><br>
          Row:
          <asp:DropDownList id="List1" 
               runat="server"/>
 
          <br><br>
          <asp:Button id="Button1"
               Text="Copy Row 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

TableCellCollection Class | TableCellCollection Members | System.Web.UI.WebControls Namespace | System.Array

Show: