BaseDataList.Controls Property

Gets a System.Web.UI.ControlCollection object that contains a collection of child controls in a data listing control.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public override ControlCollection Controls { get; }
/** @property */
public ControlCollection get_Controls ()

public override function get Controls () : ControlCollection

Not applicable.

Property Value

A System.Web.UI.ControlCollection that contains a collection of child controls in a data listing control.

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.

The following code example demonstrates how to programmatically add a control to the Controls collection.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="" >
   <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);
         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();

         // 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.


<head runat="server">
    <title>BaseDataList Controls Example</title>
   <form id="form1" runat="server">
      <h3>BaseDataList Controls Example</h3>
      <b>Product List</b>
      <asp:DataGrid id="ItemsGrid"

         <HeaderStyle BackColor="#00aaaa">


Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions