Control.EnableViewState Propriedade
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.
Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante.
public:
virtual property bool EnableViewState { bool get(); void set(bool value); };public virtual bool EnableViewState { get; set; }[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }member this.EnableViewState : bool with get, set[<System.Web.UI.Themeable(false)>]
member this.EnableViewState : bool with get, setPublic Overridable Property EnableViewState As BooleanValor de Propriedade
true se o controlo do servidor mantiver o seu estado de visualização; caso contrário false. A predefinição é true.
- Atributos
Exemplos
O exemplo seguinte define a EnableViewState propriedade para false.
void Page_Load(object sender, System.EventArgs e)
{
DataBind();
// Set EnableViewState to false to disable saving of view state
// information.
myControl.EnableViewState = false;
if (!IsPostBack)
display.Enabled = false;
}
Sub Page_Load(sender As Object, e As System.EventArgs)
DataBind()
' Set EnableViewState to false to disable saving of view state
' information.
myControl.EnableViewState = False
If Not IsPostBack Then
display.Enabled = False
End If
End Sub
Observações
O estado de visualização permite que um controlo de servidor mantenha o seu estado através dos pedidos HTTP. O estado de visualização para um controlo é ativado se todas as seguintes condições forem cumpridas:
A EnableViewState propriedade para a página é definida para
true.A EnableViewState propriedade do controlo é definida como
true.A ViewStateMode propriedade do controlo é definida para Enabled ou herda a Enabled definição.
Para obter mais informações, consulte a propriedade ViewStateMode.
O estado de vista de um controlo de servidor é a acumulação de todos os valores das suas propriedades. Para preservar estes valores entre os pedidos HTTP, ASP.NET utiliza uma instância da classe StateBag para armazenar os valores das propriedades. Os valores são então passados como variável para um campo oculto quando os pedidos subsequentes são processados. Para mais informações sobre o estado de visualização, consulte ASP.NET Visão Geral do Estado.
Há momentos em que é apropriado desativar o estado da visualização, especialmente para melhorar o desempenho da aplicação. Por exemplo, se estiver a carregar um pedido de base de dados num controlo de servidor, defina esta propriedade para false. Se não o fizer, será desperdiçado tempo de processador a carregar o estado da vista no controlo do servidor, que só será sobreposto pela consulta da base de dados. Se EnableViewState for false, podes usar o estado de controlo para persistir informação de propriedade que é específica de um controlo e que não pode ser desligada como a propriedade de estado de visualização. Para mais informações sobre a diferença entre estado de controlo e estado de visualização, veja Exemplo de Estado de Controlo vs. Estado de Visualização.
Para informações sobre como ativar ou desativar declarativamente o estado de visualização para uma página de ASP.NET, consulte @ Página.