DataGridColumnCollection.CopyTo Method (Array, Int32)
.NET Framework (current version)
Copies the items from the DataGridColumnCollection collection to the specified System.Array, starting at the specified index in the System.Array.
Assembly: System.Web (in System.Web.dll)
Parameters
- array
-
Type:
System.Array
A zero-based System.Array that receives the copied items from the DataGridColumnCollection.
- index
-
Type:
System.Int32
The first position in the specified System.Array to receive the copied contents.
Implements
ICollection.CopyTo(Array, Int32)| Exception | Condition |
|---|---|
| ArgumentNullException | array is null. |
Use this method to copy the contents of the DataGridColumnCollection collection into the specified System.Array, starting at the specified index.
Note |
|---|
The array parameter must be a zero-based System.Array. |
The following code example demonstrates how to use the CopyTo method to copy the contents of the DataGridColumnCollection collection to an array of DataGridColumn objects.
<%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <script language="VB" runat="server"> Function CreateDataSource() As ICollection Dim dt As New DataTable() Dim dr As DataRow dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32))) dt.Columns.Add(New DataColumn("StringValue", GetType(String))) dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double))) Dim i As Integer For i = 0 To 8 dr = dt.NewRow() dr(0) = i dr(1) = "Item " & i.ToString() dr(2) = 1.23 *(i + 1) dt.Rows.Add(dr) Next i Dim dv As New DataView(dt) Return dv End Function 'CreateDataSource Sub Page_Load(sender As Object, e As EventArgs) If Not IsPostBack Then ' Load this data only once. ItemsGrid.DataSource = CreateDataSource() ItemsGrid.DataBind() End If End Sub 'Page_Load Sub Button_Click(sender As Object, e As EventArgs) Dim myArray(3) As DataGridColumn ItemsGrid.Columns.CopyTo(myArray, 0) Label1.Text = "The heading text for the items in the array are: " & "<br />" & "<br />" Dim column As DataGridColumn For Each column In myArray Label1.Text &= column.HeaderText & "<br />" Next column End Sub 'Button_Click </script> <head runat="server"> <title>DataGridColumnCollection CopyTo Example</title> </head> <body> <form id="form1" runat="server"> <h3>DataGridColumnCollection CopyTo Example</h3> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" AutoGenerateColumns="false" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <Columns> <asp:BoundColumn HeaderText="Item Number" DataField="IntegerValue"/> <asp:BoundColumn HeaderText="Item" DataField="StringValue"/> <asp:BoundColumn HeaderText="Price" DataField="CurrencyValue" DataFormatString="{0:c}"> <ItemStyle HorizontalAlign="right"> </ItemStyle> </asp:BoundColumn> </Columns> </asp:DataGrid> <br /> <asp:Button id="Button1" Text="Copy DataGridColumnsCollection to Array" OnClick="Button_Click" runat="server"/> <br /> <asp:Label id="Label1" runat="server"/> </form> </body> </html>
.NET Framework
Available since 1.1
Available since 1.1
Show:
