HtmlTableRowCollection.CopyTo(Array, Int32) Method
Definition
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 HtmlTableRowCollection collection to the specified Array object, starting at 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 HtmlTableRowCollection.
- index
- Int32
The first index in the specified array to receive the items.
Implements
Examples
The following code example demonstrates how to use the CopyTo method to create an array that contains the same contents as the HtmlTableRowCollection collection. The array is then iterated through to display the contents of the collection.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
HtmlTableRow[] myRowArray = new HtmlTableRow[2];
// Copy the collection to an array.
Table1.Rows.CopyTo(myRowArray, 0);
Span1.InnerText = "The copied items from the selected row are: ";
// Iterate through the array and display its contents.
foreach (HtmlTableRow row in myRowArray)
{
Span1.InnerText = Span1.InnerText + " " + row.Cells[0].InnerText +
" " + row.Cells[1].InnerText;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTableRowCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTableRowCollection Example</h3>
<table id="Table1" runat="server"
style="border-width: 1; border-color: Black">
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
</tr>
<tr>
<td>
Cell 3
</td>
<td>
Cell 4
</td>
</tr>
</table>
<br /><br />
<input type="button"
value="Display row contents in the table"
onserverclick = "Button_Click"
runat="server"/>
<br /><br />
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim myRowArray(1) As HtmlTableRow
Dim row As HtmlTableRow
' Copy the collection to an array.
Table1.Rows.CopyTo(myRowArray, 0)
Span1.InnerText = "The copied items from the selected row are: "
' Iterate through the array and display its contents.
For Each row In myRowArray
Span1.InnerText = Span1.InnerText & " " & row.Cells(0).InnerText & _
" " & row.Cells(1).InnerText
Next row
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTableRowCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTableRowCollection Example</h3>
<table id="Table1" runat="server"
style="border-width: 1; border-color: Black">
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
</tr>
<tr>
<td>
Cell 3
</td>
<td>
Cell 4
</td>
</tr>
</table>
<br /><br />
<input type="button"
value="Display row contents in the table"
onserverclick = "Button_Click"
runat="server"/>
<br /><br />
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
Remarks
Use this method to copy the contents of the HtmlTableRowCollection collection into the specified System.Array object, starting at the specified index in the array.
Note
The array
parameter must be a zero-based System.Array.