Control.SaveViewState Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Guarda quaisquer alterações de estado de visualização no controlo do servidor que tenham ocorrido desde o momento em que a página foi publicada de volta no servidor.
protected:
virtual System::Object ^ SaveViewState();protected virtual object SaveViewState();abstract member SaveViewState : unit -> obj
override this.SaveViewState : unit -> objProtected Overridable Function SaveViewState () As ObjectDevoluções
Devolve o estado atual de visualização do controlo do servidor. Se não houver estado de vista associado ao controlo, este método devolve null.
Exemplos
O exemplo seguinte sobrepõe o método SaveViewState num controlo personalizado ASP.NET servidor. Quando este método é invocado, determina se o controlo tem algum controlo filho e se o objeto que contém Page é o resultado de um postback. Se ambos forem verdadeiros, altera a Text propriedade de um Label controlo de servidor Web para ler Custom Control Has Saved State. Depois, guarda o estado de vista do controlo como um array de objetos, denominados allStates.
protected override object SaveViewState()
{ // Change Text Property of Label when this function is invoked.
if(HasControls() && (Page.IsPostBack))
{
((Label)(Controls[0])).Text = "Custom Control Has Saved State";
}
// Save State as a cumulative array of objects.
object baseState = base.SaveViewState();
string userText = UserText;
string passwordText = PasswordText;
object[] allStates = new object[3];
allStates[0] = baseState;
allStates[1] = userText;
allStates[2] = PasswordText;
return allStates;
}
Protected Overrides Function SaveViewState() As Object
' Change Text Property of Label when this function is invoked.
If HasControls() And Page.IsPostBack Then
CType(Controls(0), Label).Text = "Custom Control Has Saved State"
End If
' Save State as a cumulative array of objects.
Dim baseState As Object = MyBase.SaveViewState()
Dim _userText As String = UserText
Dim _passwordText As String = PasswordText
Dim allStates(3) As Object
allStates(0) = baseState
allStates(1) = _userText
allStates(2) = PasswordText
Return allStates
End Function
Observações
O estado de visualização é a acumulação dos valores das propriedades de um controlo de servidor. Estes valores são automaticamente colocados na propriedade do ViewState controlo do servidor, que é uma instância da StateBag classe. O valor desta propriedade é então mantido para um objeto string após a fase de save state do ciclo de vida do controlo do servidor. Para mais informações, consulte ASP.NET Visão Geral do Ciclo de Vida da Página.
Quando o estado da vista é guardado, este objeto string é devolvido ao cliente como uma variável armazenada num elemento HTML HIDDEN . Quando cria um controlo de servidor personalizado com um estado de vista personalizado, o estado da vista pode ser gerido explicitamente com os SaveViewState métodos e.LoadViewState Para mais informações, consulte ASP.NET Visão Geral da Gestão do Estado. Para informações sobre a implementação de um fornecedor personalizado de estado de sessão, consulte Implementar um Fornecedor de Session-State Store.