WebControl.SaveViewState Método

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Salva qualquer estado que foi modificado depois que o método TrackViewState() foi invocado.

protected:
 override System::Object ^ SaveViewState();

protected override object SaveViewState ();

override this.SaveViewState : unit -> obj

Protected Overrides Function SaveViewState () As Object

Retornos

Object

Um objeto que contém o estado de exibição atual do controle, caso contrário, se não houver nenhum estado de exibição associado ao controle, null.

Comentários

O SaveViewState método é usado principalmente por desenvolvedores de controle.

O estado de exibição são os valores cumulativos das propriedades de um controle de servidor. Esses valores são colocados automaticamente na ViewState propriedade para o controle de servidor, que é uma instância da StateBag classe . Em ViewState seguida, o valor da propriedade é persistido em um objeto de cadeia de caracteres após o estágio de estado de salvamento do ciclo de vida do controle de servidor. Para obter mais informações, consulte Visão geral do ciclo de vida da página ASP.NET.

Quando o estado de exibição é salvo, esse objeto de cadeia de caracteres é retornado ao cliente como uma variável armazenada em um elemento HTML input oculto. Ao criar controles de servidor personalizados, você pode melhorar a eficiência substituindo o SaveViewState método e modificando a propriedade para o ViewState controle do servidor. Para obter mais informações, consulte Visão geral do Gerenciamento de Estado do ASP.NET.

Confira também

• ViewState
• IsTrackingViewState
• Desenvolvendo controles de servidores ASP.NET personalizados
• Estado de controle versus exemplo de estado de exibição
• Visão geral do Gerenciamento de Estado do ASP.NET
• Introdução ao ciclo de vida da página ASP.NET