ControlCollection-Konstruktor

Artikel
08/20/2007

Initialisiert eine neue Instanz der ControlCollection-Klasse für das angegebene übergeordnete Serversteuerelement.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Sub New ( _
    owner As Control _
)
'Usage
Dim owner As Control

Dim instance As New ControlCollection(owner)

public ControlCollection (
    Control owner
)

public:
ControlCollection (
    Control^ owner
)

public ControlCollection (
    Control owner
)

public function ControlCollection (
    owner : Control
)

Parameter

owner
Das ASP.NET-Serversteuerelement, für das die Steuerelementauflistung erstellt wurde.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Tritt ein, wenn der owner-Parameter NULL (Nothing in Visual Basic) ist.

Beispiel

Im folgenden Codebeispiel wird eine benutzerdefinierte ControlCollection-Klasse mit überschriebenem Konstruktor dargestellt, der Meldungen einschließlich des Namens der Owner-Eigenschaft in das Ablaufverfolgungsprotokoll schreibt, wenn eine Instanz der Auflistung erstellt wird. Sie müssen die Ablaufverfolgung für die Seite oder Anwendung aktivieren, um dieses Beispiel auszuführen.

' Create a custom ControlCollection that writes
' information to the Trace log when an instance
' of the collection is created.
<AspNetHostingPermission(SecurityAction.Demand, _
   Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomControlCollection
    Inherits ControlCollection

    Private context As HttpContext

    Public Sub New(ByVal owner As Control)
        MyBase.New(owner)
        HttpContext.Current.Trace.Write("The control collection is created.")
        ' Display the Name of the control
        ' that uses this collection when tracing is enabled.
        HttpContext.Current.Trace.Write("The owner is: " _
      & Me.Owner.ToString())
    End Sub


End Class

// Create a custom ControlCollection that writes
// information to the Trace log when an instance
// of the collection is created.
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class CustomControlCollection : ControlCollection
{
    private HttpContext context;

    public CustomControlCollection(Control owner)
        : base(owner)
    {

        HttpContext.Current.Trace.Write("The control collection is created.");
        // Display the Name of the control
        // that uses this collection when tracing is enabled.
        HttpContext.Current.Trace.Write("The owner is: " + this.Owner.ToString());
    }
}

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

ControlCollection-Klasse
ControlCollection-Member
System.Web.UI-Namespace
Control.Controls-Eigenschaft
Control-Klasse

Freigeben über