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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.
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.true if the server control maintains its view state; otherwise false. O padrão é true.The default is true.
- Atributos
Exemplos
O exemplo a seguir define a EnableViewState propriedade como false .The following example sets the EnableViewState property to 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 nas solicitações HTTP.View state enables a server control to maintain its state across HTTP requests. O estado de exibição de um controle será habilitado se todas as condições a seguir forem atendidas:View state for a control is enabled if all of the following conditions are met:
A EnableViewState propriedade da página é definida como
true.The EnableViewState property for the page is set totrue.A EnableViewState Propriedade do controle é definida como
true.The EnableViewState property for the control is set totrue.A ViewStateMode Propriedade do controle é definida como Enabled ou herda a Enabled configuração.The ViewStateMode property for the control is set to Enabled or inherits the Enabled setting.
Para obter mais informações, consulte a propriedade ViewStateMode.For more information, see the ViewStateMode property.
O estado de exibição de um controle de servidor é o acúmulo de todos os seus valores de propriedade.A server control's view state is the accumulation of all its property values. Para preservar esses valores em solicitações HTTP, o ASP.NET usa uma instância da StateBag classe para armazenar os valores de propriedade.In order to preserve these values across HTTP requests, ASP.NET uses an instance of the StateBag class to store the property values. Em seguida, os valores são passados como uma variável para um campo oculto quando as solicitações subsequentes são processadas.The values are then passed as a variable to a hidden field when subsequent requests are processed. Para obter mais informações sobre o estado de exibição, consulte visão geral do estado de exibição do ASP.net.For more information about view state, see ASP.NET View State Overview.
Há ocasiões em que é apropriado desabilitar o estado de exibição, particularmente para melhorar o desempenho do aplicativo.There are times when it is appropriate to disable view state, particularly to improve application performance. Por exemplo, se você estiver carregando uma solicitação de banco de dados em um controle de servidor, defina essa propriedade como false .For example, if you are loading a database request into a server control, set this property to false. Se você não tiver, o tempo do processador será desperdiçado carregando o estado de exibição no controle de servidor que só será substituído pela consulta do banco de dados.If you do not, processor time will be wasted loading view state into the server control that will only be overridden by the database query. Se EnableViewState for false , você pode usar o estado de controle para manter informações de propriedade específicas a um controle e não pode ser desativada como a propriedade de estado de exibição.If EnableViewState is false, you can use the control state to persist property information that is specific to a control and cannot be turned off like the view state property. Para obter mais informações sobre a diferença entre o estado de controle e o estado de exibição, consulte estado de controle versus exemplo de estado de exibição.For more information on the difference between control state and view state, see Control State vs. View State Example.
Para obter informações sobre como habilitar ou desabilitar o estado de exibição declarativamente para uma página do ASP.NET, consulte a @ página.For information about how to enable or disable view state declaratively for an ASP.NET page, see @ Page.
Aplica-se a
Confira também
- ViewStateMode
- ViewState
- LoadViewState(Object)
- SaveViewState()
- IsViewStateEnabled
- Introdução ao ciclo de vida da página ASP.NETIntroduction to the ASP.NET Page Life Cycle
- Visão geral do gerenciamento de estado ASP.NETASP.NET State Management Overview
- Exemplo de estado de controle versus estado de exibiçãoControl State vs. View State Example