Table.CreateControlCollection 方法

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

建立一個新 ControlCollection 物件來存放 TableRow 目前 Table 控制項的控制項。

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

傳回

ControlCollection

一個 ControlCollection 用來包含 TableRow 當前 Table 控制項控制項的物件。

範例

以下範例說明如何在自訂伺服器控制項中覆寫該CreateControlCollection方法，使其每次都會回傳該類別的新實例EmptyControlCollection。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

備註

此方法主要由控制開發者在從 Table 控制項衍生出自訂類別時使用。

此方法會 CreateControlCollection 覆寫基底 Control 類別的實作。 對於控制項Table，總是CreateControlCollection回傳只能包含ControlCollection當前TableRow控制項控制的 aTable。

適用於

另請參閱