TableCellCollection.CopyTo(Array, Int32) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Copies the items from the TableCellCollection to the specified Array, starting with the specified index in the Array.

public:
 virtual void CopyTo(Array ^ array, int index);

public void CopyTo (Array array, int index);

abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit

Public Sub CopyTo (array As Array, index As Integer)

Parameters

array: Array

A zero-based Array that receives the copied items from the TableCellCollection.

index: Int32

The first index in the specified Array to receive the items.

Implements

CopyTo(Array, Int32)

Examples

The following example demonstrates how to use the CopyTo method to copy the items from the TableCellCollection into the specified array.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<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 rowNum = 0; rowNum < numrows; rowNum++) 
        {          
            TableRow rw = new TableRow();
            for (int cellNum = 0; cellNum < numcells; cellNum++) 
            {
                TableCell cel = new TableCell();
                cel.Text=counter.ToString();
                rw.Cells.Add(cel);
                counter++;
            }
            Table1.Rows.Add(rw);
        }

        if (!IsPostBack) 
        {
            // Create a DropDownList for the number of rows.
            for (int rowNum = 0; rowNum < numrows; rowNum++) 
            {
                a_row.Add(rowNum.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 cel in myCellArray) 
        {
            Label1.Text = Label1.Text + " " + cel.Text;
        }
    }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TableCellCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TableCellCollection Example</h3>
    <asp:Table id="Table1" 
        GridLines="Both" 
        HorizontalAlign="Center" 
        Font-Names="Verdana" 
        Font-Size="8pt" 
        CellPadding="15" 
        CellSpacing="0" 
        runat="server" />

        <p style="text-align:center">Select a row:
            <br />&nbsp;<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" />
       </p>
 
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<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 rowNum As Integer
        For rowNum = 0 To numrows - 1
            Dim rw As New TableRow()
            Dim cellNum As Integer
            For cellNum = 0 To numcells - 1
                Dim cel As New TableCell()
                cel.Text = counter.ToString()
                rw.Cells.Add(cel)
                counter += 1
            Next
            Table1.Rows.Add(rw)
        Next

        If Not IsPostBack Then
            ' Create a DropDownList for the number of rows.
            For rowNum = 0 To numrows - 1
                a_row.Add(rowNum.ToString())
            Next

            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 cel As TableCell
        For Each cel In  myCellArray
            Label1.Text = Label1.Text & " " & cel.Text
                
        Next
    End Sub
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TableCellCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TableCellCollection Example</h3>
    <asp:Table id="Table1" 
        GridLines="Both" 
        HorizontalAlign="Center" 
        Font-Names="Verdana" 
        Font-Size="8pt" 
        CellPadding="15" 
        CellSpacing="0" 
        runat="server" />

        <p style="text-align:center">Select a row:
            <br />&nbsp;<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" />
       </p>
 
    </div>
    </form>
</body>
</html>

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.

Applies to