ControlCollection(Control) Constructor

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Inicializa una instancia nueva de la clase ControlCollection para el control de servidor principal especificado.

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)

Parámetros

owner

Control

Control de servidor ASP.NET para el que se crea la colección de controles.

Excepciones

ArgumentNullException

Se produce si el parámetro owner es null.

Ejemplos

El ejemplo de código siguiente es una clase personalizada ControlCollection que invalida el constructor para escribir mensajes (que incluyen el nombre de la Owner propiedad) en el registro de seguimiento cuando se crea una instancia de la colección. Debe habilitar el seguimiento de la página o aplicación para que este ejemplo funcione.

// 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

Consulte también

• Controls
• Control