Control.SaveControlState Méthode

Définition

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

Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur.

protected public:
 virtual System::Object ^ SaveControlState();
protected internal virtual object SaveControlState();
abstract member SaveControlState : unit -> obj
override this.SaveControlState : unit -> obj
Protected Friend Overridable Function SaveControlState () As Object

Retours

Object

Retourne l’état actuel du contrôle serveur. S’il n’existe aucun état associé au contrôle, cette méthode retourne null.

Exemples

L’exemple de code suivant remplace la méthode SaveControlState dans un contrôle ASP.NET personnalisé. Lorsque cette méthode est appelée, elle détermine si la propriété currentIndex interne est définie sur une valeur non par défaut et, le cas échéant, enregistre la valeur pour contrôler l’état.

La OnInit méthode est remplacée pour appeler la RegisterRequiresControlState méthode sur la Page méthode pour indiquer que le contrôle personnalisé utilise l’état du contrôle.

public class Sample : Control {
    private int currentIndex = 0;
   
    protected override void OnInit(EventArgs e) {
        Page.RegisterRequiresControlState(this);
        base.OnInit(e);
    }

    protected override object SaveControlState() {
        return currentIndex != 0 ? (object)currentIndex : null;
    }

    protected override void LoadControlState(object state) {
        if (state != null) {
            currentIndex = (int)state;
        }
    }
}

Class Sample
  Inherits Control
  
  Dim currentIndex As Integer
  
      Protected Overrides Sub OnInit(ByVal e As EventArgs)
          Page.RegisterRequiresControlState(Me)
          currentIndex = 0
          MyBase.OnInit(e)
      End Sub
  
      Protected Overrides Function SaveControlState() As Object
          If currentIndex <> 0 Then
              Return CType(currentIndex, Object)
          Else
              Return Nothing
          End If
      End Function
  
      Protected Overrides Sub LoadControlState(ByVal state As Object)
          If (state <> Nothing) Then
              currentIndex = CType(state, Integer)
          End If
      End Sub
  
End Class

Remarques

Utilisez la SaveControlState méthode pour enregistrer les informations d’état requises pour l’opération d’un contrôle spécifique. Ces données d’état de contrôle sont stockées séparément des données d’état d’affichage du contrôle.

Les contrôles personnalisés utilisant l’état de contrôle doivent appeler la RegisterRequiresControlState méthode sur l’état Page avant d’enregistrer l’état du contrôle.

Notes pour les héritiers

Lorsque l’état du contrôle est enregistré, un objet de chaîne est retourné au client en tant que variable stockée dans un élément HTML HIDDEN . Remplacez cette méthode pour extraire les informations d’état à utiliser dans votre contrôle.

L’état du contrôle est destiné à de petites quantités de données critiques, telles qu’un index de page ou un mot clé. L’utilisation de l’état de contrôle pour de grandes quantités de données peut affecter les performances des pages. Pour plus d’informations, consultez ASP.NET Vue d’ensemble de la gestion de l’état.

S’applique à

Voir aussi