BaseDataList.Controls Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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 Value

Type: System.Web.UI.ControlCollection

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">




.NET Framework
Available since 1.1
Return to top