DetailsViewRowCollection.CopyTo Method (DetailsViewRow(), Int32)
Copies all the items from this DetailsViewRowCollection object to the specified Array object, starting at the specified index in the Array.
Assembly: System.Web (in System.Web.dll)
Parameters
- array
-
Type:
System.Web.UI.WebControls.DetailsViewRow()
A zero-based Array that receives the copied items from the DetailsViewRowCollection.
- index
-
Type:
System.Int32
The first index in the specified Array to receive the copied contents.
Use this method to copy the items in the DetailsViewRowCollection object into the specified array, starting at the specified index. The array can then be used to access the items in the collection.
Note |
|---|
You must use a zero-based array for the array parameter. |
The following code example demonstrates how to use the CopyTo method to copy the items in a DetailsViewRowCollection object to an array. The array is then iterated through and the value of each row is displayed on the page.
<%@ 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 SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs) ' Use the Count property to determine whether the ' Rows collection contains any item. If ItemDetailsView.Rows.Count > 0 Then MessageLabel.Text = "The row values are: <br/><br/>" ' Copy the items in the Rows collection to an array. Dim rowArray(ItemDetailsView.Rows.Count - 1) As DetailsViewRow ItemDetailsView.Rows.CopyTo(rowArray, 0) ' Iterate though the array and display the value in the ' first cell of the row. Dim row As DetailsViewRow For Each row In rowArray ' Use the Text property to access the value of ' each cell. In this example, the cells in the ' first column (index 0) contains the field names, ' while the cells in the second column (index 1) ' contains the field value. MessageLabel.Text &= row.Cells(0).Text & " = " & _ row.Cells(1).Text & "<br/>" Next Else MessageLabel.Text = "No items." End If End Sub </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>DetailsViewRowCollection CopyTo Example</title> </head> <body> <form id="form1" runat="server"> <h3>DetailsViewRowCollection CopyTo Example</h3> <asp:detailsview id="ItemDetailsView" datasourceid="DetailsViewSource" allowpaging="true" autogeneraterows="false" runat="server"> <fields> <asp:boundfield datafield="CustomerID" headertext="Customer ID"/> <asp:boundfield datafield="CompanyName" headertext="Company Name"/> <asp:boundfield datafield="Address" headertext="Address"/> <asp:boundfield datafield="City" headertext="City"/> <asp:boundfield datafield="PostalCode" headertext="ZIP Code"/> <asp:boundfield datafield="Country" headertext="Country"/> </fields> </asp:detailsview> <br/> <asp:button id="SubmitButton" text="Display Row Values" onclick="SubmitButton_Click" runat="server"/> <br/><br/> <asp:label id="MessageLabel" forecolor="Red" runat="server"/> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the web.config file. --> <asp:sqldatasource id="DetailsViewSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" connectionstring= "<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
Available since 2.0
