Control.LoadControlState(Object) Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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

Parâmetros

savedState
Object

Um Object que representa o estado de controle a ser restaurado.

Exemplos

O exemplo de código a seguir substitui o LoadControlState método em um controle de ASP.NET personalizado. Quando esse método é invocado, ele determina se o estado de controle foi salvo anteriormente para o controle e, nesse caso, define a propriedade currentIndex interna como o valor salvo.

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.

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. Para obter mais informações, consulte ASP.NET Visão geral do Gerenciamento de Estado.

Aplica-se a

Confira também