Control.LoadControlState(Object) Método

Definição

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método 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)

Parâmetros

savedState
Object

Um Object que representa o estado de controle a ser restaurado.An Object that represents the control state to be restored.

Exemplos

O exemplo de código a seguir substitui o LoadControlState método em um controle ASP.net personalizado.The following code example overrides the LoadControlState method in a custom ASP.NET control. Quando esse método é invocado, ele determina se o estado de controle foi salvo anteriormente para o controle e, em caso afirmativo, define a propriedade interna currentIndex como o valor salvo.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.

O OnInit método é substituído para chamar o RegisterRequiresControlState método no Page para indicar que o controle personalizado usa o estado de controle.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

Comentários

Substitua esse método quando precisar especificar como um controle de servidor personalizado restaura seu estado de controle.Override this method when you need to specify how a custom server control restores its control state. Para obter mais informações, consulte visão geral do gerenciamento de estado ASP.net.For more information, see ASP.NET State Management Overview.

Aplica-se a

Confira também