This documentation is archived and is not being maintained.

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

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


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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0
Show: