GridViewRowCollection.CopyTo(GridViewRow[], Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Copia todos los elementos de la colección GridViewRowCollection en el objeto Array especificado, comenzando en el índice especificado del objeto Array.
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[]
Objeto Array de base cero que recibe los elementos copiados del objeto GridViewRowCollection.
Ejemplos
En el ejemplo siguiente se muestra cómo usar el CopyTo método para copiar los elementos de la colección en una matriz. La matriz se recorre en iteración y los valores de la primera celda se muestran en la página.
<%@ 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>
Comentarios
Utilice este método para copiar los elementos del GridViewRowCollection objeto en el objeto especificado System.Array , empezando por el índice especificado. A System.Array continuación, el objeto se puede usar para tener acceso a los elementos de la colección.
Nota:
Debe usar un objeto de base System.Array cero para el array
parámetro .