Control.LoadControlState(Object) Metodo

Definizione

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo 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)

Parametri

savedState
Object

Oggetto Object che rappresenta lo stato del controllo da ripristinare.An Object that represents the control state to be restored.

Esempi

Nell'esempio di codice seguente viene eseguito l'override del metodo LoadControlState in un controllo ASP.NET personalizzato.The following code example overrides the LoadControlState method in a custom ASP.NET control. Quando viene richiamato, questo metodo determina se lo stato del controllo è stato salvato in precedenza per il controllo e, in caso affermativo, imposta la proprietà interna currentIndex sul valore salvato.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.

Viene eseguito l'override del metodo OnInit per chiamare il metodo RegisterRequiresControlState sul Page per indicare che il controllo personalizzato usa lo stato del controllo.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

Commenti

Eseguire l'override di questo metodo quando è necessario specificare la modalità di ripristino dello stato del controllo da un controllo server personalizzato.Override this method when you need to specify how a custom server control restores its control state. Per altre informazioni, vedere Panoramica della gestione dello stato di ASP.NET.For more information, see ASP.NET State Management Overview.

Si applica a

Vedi anche