Compartilhar via


Control.EnableViewState Propriedade

Definição

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele 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, set
Public Overridable Property EnableViewState As Boolean

Valor da propriedade

true se o controle de servidor mantiver seu estado de exibição; caso contrário, false. O padrão é true.

Atributos

Exemplos

O exemplo a seguir define a EnableViewState propriedade como 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

Comentários

O estado de exibição permite que um controle de servidor mantenha seu estado entre solicitações HTTP. O estado de exibição de um controle será habilitado se todas as seguintes condições forem atendidas:

Para obter mais informações, consulte a propriedade ViewStateMode.

O estado de exibição de um controle de servidor é o acúmulo de todos os seus valores de propriedade. Para preservar esses valores entre solicitações HTTP, ASP.NET usa uma instância da StateBag classe para armazenar os valores da propriedade. Os valores são então passados como uma variável para um campo oculto quando as solicitações subsequentes são processadas. Para obter mais informações sobre o estado de exibição, consulte ASP.NET Exibir Visão Geral do Estado.

Há momentos em que é apropriado desabilitar o estado de exibição, especialmente para melhorar o desempenho do aplicativo. Por exemplo, se você estiver carregando uma solicitação de banco de dados em um controle de servidor, defina essa propriedade como false. Se você não fizer isso, o tempo do processador será desperdiçado carregando o estado de exibição no controle do servidor que só será substituído pela consulta de banco de dados. Se EnableViewState for false, você poderá usar o estado de controle para persistir informações de propriedade específicas de um controle e não podem ser desativadas como a propriedade de estado de exibição. Para obter mais informações sobre a diferença entre o estado de controle e o estado de exibição, consulte Estado de controle vs. Exemplo de estado de exibição.

Para obter informações sobre como habilitar ou desabilitar o estado de exibição declarativamente para uma página ASP.NET, consulte @ Page.

Aplica-se a

Confira também