Control.LoadControlState(Object) Control.LoadControlState(Object) Control.LoadControlState(Object) Control.LoadControlState(Object) Method

Définition

Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

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

Object représentant l'état du contrôle à restaurer.An Object that represents the control state to be restored.

Exemples

L’exemple de code suivant remplace la LoadControlState méthode dans un contrôle ASP.NET personnalisé.The following code example overrides the LoadControlState method in a custom ASP.NET control. Lorsque cette méthode est appelée, elle détermine si l’état du contrôle a été précédemment enregistré pour le contrôle et, si tel est le cas currentIndex , affecte à la propriété interne la valeur enregistrée.When this method is invoked, it determines whether control state was previously saved for the control and, if so, sets the internal property currentIndex to the saved value.

La OnInit méthode est substituée pour appeler la RegisterRequiresControlState méthode sur le Page pour indiquer que le contrôle personnalisé utilise l’état du contrôle.The OnInit method is overridden to call the RegisterRequiresControlState method on the Page to indicate that the custom control uses control state.

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

Substituez cette méthode lorsque vous devez spécifier la manière dont un contrôle serveur personnalisé restaure son état de contrôle.Override this method when you need to specify how a custom server control restores its control state. Pour plus d’informations, consultez vue d’ensemble de la gestion d’état ASP.net.For more information, see ASP.NET State Management Overview.

S’applique à

Voir aussi