Exporter (0) Imprimer
Développer tout

Control.ClearChildState, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur.

Espace de noms : System.Web.UI
Assembly : System.Web (dans system.web.dll)

protected void ClearChildState ()
protected void ClearChildState ()
protected function ClearChildState ()

La méthode ClearChildState efface toutes les informations sur l'état d'affichage et sur l'état du contrôle des contrôles enfants. Elle équivaut à appeler la méthode ClearChildViewState et la méthode ClearChildControlState.

Lorsque vous recréez les contrôles enfants d'un objet Control, utilisez la méthode ClearChildState pour effacer l'état enfant afin qu'il ne soit pas appliqué par inadvertance aux nouveaux contrôles.

L'exemple de code suivant montre comment substituer la méthode OnDataBinding pour un contrôle lié aux données et basé sur un des modèles. Si la source de données auquel le contrôle se lie est remplie, la collection ControlCollection du contrôle est vidée à l'aide de la méthode Clear, et la méthode ClearChildState est utilisée pour supprimer les informations sur l'état d'affichage éventuellement enregistrées pour les contrôles enfants.

// Override to create the repeated items from the DataSource.
protected override void OnDataBinding(EventArgs e) {
    base.OnDataBinding(e);

    if (DataSource != null) {
        // Clear any existing child controls.
        Controls.Clear();
        // Clear any previous state for the existing child controls.
        ClearChildState();

        // Iterate over the DataSource, creating a new item for each data item.
        IEnumerator dataEnum = DataSource.GetEnumerator();
        int i = 0;
        while(dataEnum.MoveNext()) {

            // Create an item.
            RepeaterItem item = new RepeaterItem(i, dataEnum.Current);
            // Initialize the item from the template.
            ItemTemplate.InstantiateIn(item);
            // Add the item to the ControlCollection.
            Controls.Add(item);

            i++;
        }

        // Prevent child controls from being created again.
        ChildControlsCreated = true;
        // Store the number of items created in view state for postback scenarios.
        ViewState["NumItems"] = i;
    }
}

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft