Control.EnableViewState Propriedade

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.

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

Boolean

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

Atributos: ThemeableAttribute

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:

A EnableViewState propriedade da página está definida como true.
A EnableViewState propriedade do controle está definida como true.
A ViewStateMode propriedade do controle é definida Enabled ou herda a Enabled configuração.

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 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ê pode usar o estado de controle para persistir informações de propriedade específicas de um controle e não pode ser desativada como a propriedade de estado de exibição. Para obter mais informações sobre a diferença entre o estado do controle e o estado de exibição, consulte Estado de Controle versus 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