GridViewRowCollection.CopyTo(GridViewRow[], Int32) Método
Definição
Copia os itens desse GridViewRowCollection para o objeto Array especificado, começando no índice especificado no objeto Array.Copies all the items from this GridViewRowCollection to the specified Array object, starting at the specified index in the Array object.
public:
void CopyTo(cli::array <System::Web::UI::WebControls::GridViewRow ^> ^ array, int index);
public void CopyTo (System.Web.UI.WebControls.GridViewRow[] array, int index);
member this.CopyTo : System.Web.UI.WebControls.GridViewRow[] * int -> unit
Public Sub CopyTo (array As GridViewRow(), index As Integer)
Parâmetros
- array
- GridViewRow[]
Um objeto Array baseado em zero que recebe os itens copiados do objeto GridViewRowCollection.A zero-based Array object that receives the copied items from the GridViewRowCollection object.
- index
- Int32
O primeiro índice no objeto Array especificado para receber os conteúdos copiados.The first index in the specified Array object to receive the copied contents.
Exemplos
O exemplo a seguir demonstra como usar o CopyTo método para copiar os itens da coleção em uma matriz.The following example demonstrates how to use the CopyTo method to copy the items of collection into an array. A matriz é iterada e os valores da primeira célula são exibidos na página.The array is iterated through and the values of the first cell are displayed on the page.
<%@ 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 AuthorsGridView_RowCreated(Object sender, GridViewRowEventArgs e)
{
if (e.Row.RowType == DataControlRowType.Footer)
{
Message.Text = "The authors are:<br />";
// Copy the items in the Rows collection into an array.
GridViewRow[] rowArray = new GridViewRow[AuthorsGridView.Rows.Count];
AuthorsGridView.Rows.CopyTo(rowArray, 0);
// Iterate though the array and display the value in the
// first cell of the row.
foreach(GridViewRow row in rowArray)
{
Message.Text += row.Cells[0].Text + "<br />";
}
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewRowCollection CopyTo Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewRowCollection CopyTo Example</h3>
<table>
<tr>
<td>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="false"
onrowcreated="AuthorsGridView_RowCreated"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:boundfield datafield="au_fname"
headertext="First Name"/>
</columns>
</asp:gridview>
</td>
<td>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
</td>
</tr>
</table>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname] FROM [authors] WHERE [state]='CA'"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</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 AuthorsGridView_RowCreated(ByVal sender As Object, ByVal e As GridViewRowEventArgs)
If e.Row.RowType = DataControlRowType.Footer Then
Message.Text = "The authors are:<br />"
' Copy the items in the Rows collection into an array.
Dim rowArray(AuthorsGridView.Rows.Count - 1) As GridViewRow
AuthorsGridView.Rows.CopyTo(rowArray, 0)
' Iterate though the array and display the value in the
' first cell of the row.
Dim row As GridViewRow
For Each row In rowArray
Message.Text &= row.Cells(0).Text & "<br />"
Next
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewRowCollection CopyTo Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewRowCollection CopyTo Example</h3>
<table>
<tr>
<td>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="false"
onrowcreated="AuthorsGridView_RowCreated"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:boundfield datafield="au_fname"
headertext="First Name"/>
</columns>
</asp:gridview>
</td>
<td>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
</td>
</tr>
</table>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname] FROM [authors] WHERE [state]='CA'"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Comentários
Use este método para copiar os itens do GridViewRowCollection objeto para o objeto especificado System.Array , iniciando no índice especificado.Use this method to copy the items in the GridViewRowCollection object into the specified System.Array object, starting at the specified index. O System.Array objeto pode então ser usado para acessar os itens na coleção.The System.Array object can then be used to access the items in the collection.
Observação
Você deve usar um objeto com base em zero System.Array para o array parâmetro.You must use a zero-based System.Array object for the array parameter.