Control.LoadControlState(Object) Método

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 Visão geral do Gerenciamento de Estado ASP.NET.

Aplica-se a

Partilhar via