Table.CreateControlCollection Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

protected:
 override System::Web::UI::ControlCollection ^ CreateControlCollection();

protected override System.Web.UI.ControlCollection CreateControlCollection ();

override this.CreateControlCollection : unit -> System.Web.UI.ControlCollection

Protected Overrides Function CreateControlCollection () As ControlCollection

Returns

ControlCollection

A ControlCollection object to contain the TableRow controls of the current Table control.

Examples

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>

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

<!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 - VB Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Custom Table - CreateControlCollection - VB 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);
        }
    }
}

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class CustomTableCreateControlCollection
        Inherits Table

        Protected Overrides Function CreateControlCollection() As ControlCollection
            ' Return a new ControlCollection
            Return New ControlCollection(Me)
        End Function
    End Class
End Namespace

Remarks

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.

Applies to

Jaa