ControlCollection(Control) Costruttore

Definizione

Inizializza una nuova istanza della classe ControlCollection per il controllo server padre specificato.Initializes a new instance of the ControlCollection class for the specified parent server control.

public:
 ControlCollection(System::Web::UI::Control ^ owner);
public ControlCollection (System.Web.UI.Control owner);
new System.Web.UI.ControlCollection : System.Web.UI.Control -> System.Web.UI.ControlCollection
Public Sub New (owner As Control)

Parametri

owner
Control

Controllo server ASP.NET per il quale viene creato l'insieme dei controlli.The ASP.NET server control that the control collection is created for.

Eccezioni

Viene generato se il parametro owner è null.Occurs if the owner parameter is null.

Esempio

L'esempio di codice seguente è una ControlCollection classe personalizzata che esegue l'override del costruttore per scrivere i messaggi (che includono il nome della Owner proprietà) nel log di traccia quando viene creata un'istanza della raccolta.The following code example is a custom ControlCollection class that overrides the constructor to write messages (which include the name of the Owner property) to the trace log when an instance of the collection is created. Per il corretto funzionamento di questo esempio, è necessario abilitare la traccia per la pagina o l'applicazione.You must enable tracing for the page or application for this example to work.

// 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());
    }
}
' 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

Si applica a

Vedi anche