Control.LoadControlState(Object) Méthode

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.

Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().

protected public:
 virtual void LoadControlState(System::Object ^ savedState);

protected internal virtual void LoadControlState(object savedState);

abstract member LoadControlState : obj -> unit
override this.LoadControlState : obj -> unit

Protected Friend Overridable Sub LoadControlState (savedState As Object)

Paramètres

savedState: Object

Object représentant l'état du contrôle à restaurer.

Exemples

L’exemple de code suivant remplace la LoadControlState méthode dans un contrôle de ASP.NET personnalisé. Lorsque cette méthode est appelée, elle détermine si l’état du contrôle a été enregistré précédemment pour le contrôle et, si c’est le cas, définit la propriété currentIndex interne sur la valeur enregistrée.

La OnInit méthode est remplacée pour appeler la RegisterRequiresControlState méthode sur le Page 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

Remplacez cette méthode lorsque vous devez spécifier comment un contrôle serveur personnalisé restaure son état de contrôle. Pour plus d’informations, consultez ASP.NET Vue d’ensemble de la gestion de l’état.

S’applique à

Produit	Versions
.NET Framework	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

Partager via