This documentation is archived and is not being maintained.

Table.CreateControlCollection Method

Creates a new ControlCollection object to hold the TableRow controls of the current Table control.

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

protected override ControlCollection CreateControlCollection()

Return Value

Type: System.Web.UI.ControlCollection
A ControlCollection object to contain the TableRow controls of the current Table control.

This method is used primarily by control developers when deriving a custom class from a Table control.

This method overrides the CreateControlCollection implementation for the base Control class. For a Table control, the CreateControlCollection always returns a ControlCollection that can only contain TableRow controls of the current Table control.

The following code example demonstrates how to override the CreateControlCollection method in a custom server control so that it always returns a new instance of the EmptyControlCollection class for the Table.


<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>
<%@ Page Language="C#" %>

<!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" >
<head id="Head2" runat="server">
    <title>Custom Table - CreateControlCollection - C# Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Custom Table - CreateControlCollection - C# Example</h3>

    <aspSample:CustomTableCreateControlCollection runat="server"
      id="Table1" GridLines="Both" CellPadding="4">
      <asp:TableRow>
        <asp:TableCell>Row 0, Col 0</asp:TableCell>
        <asp:TableCell>Row 0, Col 1</asp:TableCell>
      </asp:TableRow>
      <asp:TableRow>
        <asp:TableCell>Row 1, Col 0</asp:TableCell>
        <asp:TableCell>Row 1, Col 1</asp:TableCell>
      </asp:TableRow>
    </aspSample:CustomTableCreateControlCollection>

    </div>
    </form>
</body>
</html>


...


using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    public sealed class CustomTableCreateControlCollection : Table
    {
        protected override ControlCollection CreateControlCollection()
        {
            // Return a new ControlCollection
            return new ControlCollection(this);
        }
    }
}


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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