Lire en anglais

Partager via

IStateManager Interface

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Définit les propriétés et les méthodes que toute classe doit implémenter pour prendre en charge la gestion de l'état d'affichage d'un contrôle serveur.

C# 
public interface IStateManager
Dérivé

Exemples

L’exemple de code suivant montre une classe qui implémente l’interface IStateManager . Il inclut des implémentations de la IsTrackingViewState propriété et des LoadViewStateméthodes , SaveViewStateet TrackViewState .

C# 
// Create a class that implements IStateManager so that
// it can manage its own view state.   
[AspNetHostingPermission(SecurityAction.Demand,
   Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class MyItem : IStateManager
{
    private string _message;

    // The StateBag object that allows you to save
    // and restore view-state information.
    private StateBag _viewstate;

    // The constructor for the MyItem class.
    public MyItem(string mesg)
    {
        _message = mesg;
        _viewstate = new StateBag();
        _viewstate.Add("message", _message);
    }

    // Create a Message property that reads from and writes
    // to view state. If the set accessor writes the message
    // value to view state, the StateBag.SetItemDirty method
    // is called, telling view state that the item has changed. 
    public string Message
    {
        get
        {
            return (string)_viewstate["message"];
        }
        set
        {
            _message = value;
            _viewstate.SetItemDirty("message", true);
        }
    }

    // Implement the LoadViewState method. If the saved view state
    // exists, the view-state value is loaded to the MyItem control. 
    void IStateManager.LoadViewState(object savedState)
    {
        _message = (string)_viewstate["message"];
        if (savedState != null)
            ((IStateManager)_viewstate).LoadViewState(savedState);
    }

    // Implement the SaveViewState method. If the StateBag
    // that stores the MyItem class's view state contains
    // a value for the message property and if the value
    // has changed since the TrackViewState method was last 
    // called, all view state for this class is deleted, 
    // using the StateBag.Clear method,and the new value is added.
    object IStateManager.SaveViewState()
    {
        // Check whether the message property exists in 
        // the ViewState property, and if it does, check
        // whether it has changed since the most recent
        // TrackViewState method call.
        if (!((IDictionary)_viewstate).Contains("message") || _viewstate.IsItemDirty("message"))
        {
            _viewstate.Clear();
            // Add the _message property to the StateBag.
            _viewstate.Add("message", _message);
        }
        return ((IStateManager)_viewstate).SaveViewState();
    }


    // Implement the TrackViewState method for this class by
    // calling the TrackViewState method of the class's private
    // _viewstate property.
    void IStateManager.TrackViewState()
    {
        ((IStateManager)_viewstate).TrackViewState();
    }

    // Implement the IsTrackingViewState method for this class 
    // by calling the IsTrackingViewState method of the class's
    // private _viewstate property. 
    bool IStateManager.IsTrackingViewState
    {
        get
        {
            return ((IStateManager)_viewstate).IsTrackingViewState;
        }
    }

    // Create a function that iterates through the view-state
    // values stored for this class and returns the
    // results as a string.
    public string EnumerateViewState()
    {
        string keyName, keyValue;
        string result = String.Empty;
        StateItem myStateItem;
        IDictionaryEnumerator myDictionaryEnumerator = _viewstate.GetEnumerator();
        while (myDictionaryEnumerator.MoveNext())
        {
            keyName = (string)myDictionaryEnumerator.Key;
            myStateItem = (StateItem)myDictionaryEnumerator.Value;
            keyValue = (string)myStateItem.Value;
            result = result + "<br>ViewState[" + keyName + "] = " + keyValue;
        }
        return result;
    }
}

Remarques

L’état d’affichage d’un contrôle serveur comprend les valeurs cumulatives des propriétés du contrôle. Cette interface inclut des méthodes qui enregistrent et chargent les valeurs d’état d’affichage d’un contrôle serveur, ainsi qu’une méthode qui indique au contrôle de suivre les modifications apportées à son état d’affichage.

Pour personnaliser la façon dont votre application ASP.NET gère l’état d’affichage du contrôle serveur, vous devez créer une classe qui implémente cette interface, car vous ne pouvez pas hériter de la StateBag classe .

Propriétés

IsTrackingViewState

Implémenté par une classe, obtient une valeur indiquant si un contrôle serveur effectue le suivi des changements de son état d'affichage.

Méthodes

LoadViewState(Object)

Implémenté par une classe, charge dans un contrôle serveur son état d'affichage précédemment enregistré.
SaveViewState()

Implémenté par une classe, enregistre les modifications de l'état d'affichage d'un contrôle serveur dans un Object.
TrackViewState()

Implémenté par une classe, commande au contrôle serveur d'effectuer le suivi des modifications de son état d'affichage.

S’applique à

Produit Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Voir aussi