GridViewRowCollection.CopyTo(GridViewRow[], Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Copia tutti gli elementi dall'insieme GridViewRowCollection nell'oggetto Array specificato, partendo dall'indice indicato nell'oggetto 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)
Parametri
- array
- GridViewRow[]
Oggetto Array in base zero che riceve gli elementi copiati dall'oggetto GridViewRowCollection.
Esempio
Nell'esempio seguente viene illustrato come utilizzare il CopyTo metodo per copiare gli elementi della raccolta in una matrice. La matrice viene iterata e i valori della prima cella vengono visualizzati nella pagina.
<%@ 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>
Commenti
Utilizzare questo metodo per copiare gli elementi nell'oggetto GridViewRowCollection specificato System.Array , a partire dall'indice specificato. L'oggetto System.Array può quindi essere utilizzato per accedere agli elementi dell'insieme.
Nota
Per il array
parametro è necessario utilizzare un oggetto in base System.Array zero.