Control.EnableViewState Control.EnableViewState Control.EnableViewState Control.EnableViewState Property

Definition

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.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); };
[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }
member this.EnableViewState : bool with get, set
Public Overridable Property EnableViewState As Boolean

Eigenschaftswert

true, wenn das Serversteuerelement seinen Ansichtszustand beibehält, andernfalls false.true if the server control maintains its view state; otherwise false. Die Standardeinstellung ist true.The default is true.

Beispiele

Im folgenden Beispiel wird die EnableViewState -Eigenschaft falseauf festgelegt.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

Hinweise

Der Ansichts Zustand ermöglicht einem Server Steuerelement, seinen Status über HTTP-Anforderungen hinweg beizubehalten.View state enables a server control to maintain its state across HTTP requests. Der Ansichts Zustand für ein Steuerelement ist aktiviert, wenn alle der folgenden Bedingungen erfüllt sind:View state for a control is enabled if all of the following conditions are met:

Weitere Informationen finden Sie in den Ausführungen zur ViewStateMode-Eigenschaft.For more information, see the ViewStateMode property.

Der Ansichts Zustand eines Server Steuer Elements ist die Ansammlung aller Eigenschaftswerte.A server control's view state is the accumulation of all its property values. Um diese Werte über HTTP-Anforderungen hinweg beizubehalten, verwendet ASP.net eine Instanz der StateBag -Klasse, um die Eigenschaftswerte zu speichern.In order to preserve these values across HTTP requests, ASP.NET uses an instance of the StateBag class to store the property values. Die Werte werden dann als Variable an ein ausgeblendetes Feld weitergegeben, wenn nachfolgende Anforderungen verarbeitet werden.The values are then passed as a variable to a hidden field when subsequent requests are processed. Weitere Informationen zum Ansichts Zustand finden Sie unter ASP.net View State Overview.For more information about view state, see ASP.NET View State Overview.

Es gibt Zeiten, in denen es sinnvoll ist, den Ansichts Zustand zu deaktivieren, insbesondere zur Verbesserung der Anwendungsleistung.There are times when it is appropriate to disable view state, particularly to improve application performance. Wenn Sie z. b. eine Daten Bank Anforderung in ein Server Steuerelement laden, legen Sie falsediese Eigenschaft auf fest.For example, if you are loading a database request into a server control, set this property to false. Andernfalls wird die Prozessorzeit beim Laden des Ansichts Zustands in das Server Steuerelement verschwendet, das nur von der Datenbankabfrage überschrieben wird.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. Wenn EnableViewState istfalse, können Sie den Steuerelement Zustand verwenden, um Eigenschafts Informationen beizubehalten, die für ein Steuerelement spezifisch sind und nicht wie die Eigenschaft Ansichts Zustand deaktiviert werden können.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. Weitere Informationen zu den Unterschieden zwischen dem Steuerelement Zustand und dem Ansichts Zustand finden Sie Untersteuern des Zustands im Vergleich zu Beispielfür den Ansichts Zustand.For more information on the difference between control state and view state, see Control State vs. View State Example.

Informationen dazu, wie Sie den Ansichts Zustand deklarativ für eine ASP.NET Seite aktivieren oder deaktivieren @ , finden Sie unter Page.For information about how to enable or disable view state declaratively for an ASP.NET page, see @ Page.

Gilt für:

Siehe auch