BaseDataList.Controls Property
Gets a System.Web.UI.ControlCollection that contains a collection of child controls in a data listing control.
[Visual Basic] Overrides Public ReadOnly Property Controls As ControlCollection [C#] public override ControlCollection Controls {get;} [C++] public: __property ControlCollection* get_Controls(); [JScript] public override function get Controls() : ControlCollection;
Property Value
A System.Web.UI.ControlCollection that contains a collection of child controls in a data listing control.
Remarks
Use the Controls collection to manage the child controls contained in a data listing control. You can add controls, remove controls, or iterate through the server controls in the collection.
Example
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> Function CreateDataSource() As ICollection ' Create sample data for the DataGrid control. Dim dt As DataTable = New DataTable() Dim dr As DataRow ' Define the columns of the table. dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32))) dt.Columns.Add(New DataColumn("StringValue", GetType(string))) dt.Columns.Add(New DataColumn("CurrencyValue", GetType(double))) ' Populate the table with sample values. 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 DataView = New DataView(dt) Return dv End Function Sub Page_Load(sender As Object, e As EventArgs) ' Load sample data only once when the page is first loaded. If Not IsPostBack Then ItemsGrid.DataSource = CreateDataSource() ItemsGrid.DataBind() End If ' Create a Label control to display the total number of items ' displayed in the DataGrid. Dim myLabel As Label = New Label() myLabel.Text = "<br><br><b>Total Number of Items: " & ItemsGrid.Items.Count.ToString() & "</b>" myLabel.ID = "SummaryLabel" ' Add the Label control to the Controls collection of the DataGrid. ItemsGrid.Controls.Add(myLabel) End Sub </script> <body> <form runat=server> <h3>BaseDataList Controls Example</h3> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" AutoGenerateColumns="True" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> </asp:DataGrid> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> ICollection CreateDataSource() { // Create sample data for the DataGrid control. DataTable dt = new DataTable(); DataRow dr; // Define columns for the data source. dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(string))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double))); // Populate data source with sample values. for (int i = 0; i < 9; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Item " + i.ToString(); dr[2] = 1.23 * (i + 1); dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { // Bind data to the DataGrid control only when the page first loads. if (!IsPostBack) { ItemsGrid.DataSource= CreateDataSource(); ItemsGrid.DataBind(); } // Create a Label control to display the total number of items // displayed in the DataGrid. Label myLabel = new Label(); myLabel.Text = "<br><br><b>Total Number of Items: " + ItemsGrid.Items.Count.ToString() + "</b>"; myLabel.ID = "SummaryLabel"; // Add the Label control to the Controls collection of the DataGrid. ItemsGrid.Controls.Add(myLabel); } </script> <body> <form runat=server> <h3>BaseDataList Controls Example</h3> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" AutoGenerateColumns="True" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> </asp:DataGrid> </form> </body> </html>
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
BaseDataList Class | BaseDataList Members | System.Web.UI.WebControls Namespace | System.Web.UI.ControlCollection