Table.CreateControlCollection-Methode
Erstellt ein neues ControlCollection-Objekt, das die TableRow-Steuerelemente des aktuellen Table-Steuerelements enthalten soll.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Overrides Function CreateControlCollection As ControlCollection
'Usage
Dim returnValue As ControlCollection
returnValue = Me.CreateControlCollection
protected override ControlCollection CreateControlCollection ()
protected:
virtual ControlCollection^ CreateControlCollection () override
protected ControlCollection CreateControlCollection ()
protected override function CreateControlCollection () : ControlCollection
Rückgabewert
Ein ControlCollection-Objekt, das die TableRow-Steuerelemente des aktuellen Table-Steuerelements enthalten soll.
Hinweise
Diese Methode wird primär von Steuerelemententwicklern beim Ableiten einer benutzerdefinierten Klasse von einem Table-Steuerelement verwendet.
Diese Methode überschreibt die CreateControlCollection-Implementierung für die Control-Basisklasse. Die CreateControlCollection gibt bei einem Table-Steuerelement immer eine ControlCollection zurück, die nur TableRow-Steuerelemente des aktuellen Table-Steuerelements enthalten kann.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie die CreateControlCollection-Methode in einem benutzerdefinierten Serversteuerelement überschrieben wird, sodass immer eine neue Instanz der EmptyControlCollection-Klasse für die Table zurückgegeben wird.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
<HEAD>
<title>Custom Table - CreateControlCollection - VB.NET Example</title>
</HEAD>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom Table - CreateControlCollection - VB.NET Example</h3>
<aspSample:CustomTableCreateControlCollection id="Table1" runat="server"
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>
</form>
</body>
</HTML>
...
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomTableCreateControlCollection
Inherits System.Web.UI.WebControls.Table
Protected Overrides Function CreateControlCollection() As System.Web.UI.ControlCollection
' Return a new EmptyControlCollection
Return New System.Web.UI.EmptyControlCollection(Me)
End Function
End Class
End Namespace
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
<HEAD>
<title>Custom Table - CreateControlCollection - C# Example</title>
</HEAD>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom Table - CreateControlCollection - C# Example</h3>
<aspSample:CustomTableCreateControlCollection
id="Table1"
runat="server"
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>
</form>
</body>
</HTML>
...
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomTableCreateControlCollection : System.Web.UI.WebControls.Table
{
protected override System.Web.UI.ControlCollection CreateControlCollection()
{
// Return a new EmptyControlCollection
return new System.Web.UI.EmptyControlCollection(this);
}
}
}
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
<HEAD>
<title>Custom Table - CreateControlCollection - VJ# Example</title>
</HEAD>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom Table - CreateControlCollection - VJ# Example</h3>
<aspSample:CustomTableCreateControlCollection
id="Table1"
runat="server"
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>
</form>
</body>
</HTML>
...
package Samples.AspNet.JSL.Controls;
public class CustomTableCreateControlCollection
extends System.Web.UI.WebControls.Table
{
protected System.Web.UI.ControlCollection CreateControlCollection()
{
// Return a new EmptyControlCollection
return new System.Web.UI.EmptyControlCollection(this);
} //CreateControlCollection
} //CustomTableCreateControlCollection
Plattformen
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
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Table-Klasse
Table-Member
System.Web.UI.WebControls-Namespace
TableRow
ControlCollection