ControlCollection(Control) Constructeur

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe ControlCollection pour le contrôle serveur parent spécifié.

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)

Paramètres

owner: Control

Contrôle serveur ASP.NET pour lequel la collection de contrôles est créée.

Exceptions

ArgumentNullException

Se produit si le paramètre owner est null.

Exemples

L’exemple de code suivant est une classe personnalisée ControlCollection qui remplace le constructeur pour écrire des messages (qui incluent le nom de la Owner propriété) dans le journal de trace lorsqu’une instance de la collection est créée. Vous devez activer le suivi de la page ou de l’application pour que cet exemple fonctionne.

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

S’applique à

Share via