Freigeben über


Control.EnableViewState Eigenschaft

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.

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

Eigenschaftswert

true, wenn das Serversteuerelement seinen Ansichtszustand beibehält, andernfalls false. Der Standardwert ist true.

Attribute

Beispiele

Im folgenden Beispiel wird die EnableViewState -Eigenschaft auf falsefestgelegt.

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 Ansichtszustand ermöglicht es einem Serversteuerelement, seinen Zustand über HTTP-Anforderungen hinweg beizubehalten. Der Ansichtszustand für ein Steuerelement ist aktiviert, wenn alle der folgenden Bedingungen erfüllt sind:

Weitere Informationen finden Sie in den Ausführungen zur ViewStateMode-Eigenschaft.

Der Ansichtszustand eines Serversteuerelements ist die Akkumulation aller Eigenschaftenwerte. Um diese Werte über HTTP-Anforderungen hinweg beizubehalten, verwendet ASP.NET eine Instanz der StateBag -Klasse, um die Eigenschaftswerte zu speichern. Die Werte werden dann als Variable an ein ausgeblendetes Feld übergeben, wenn nachfolgende Anforderungen verarbeitet werden. Weitere Informationen zum Ansichtsstatus finden Sie unter ASP.NET Übersicht über den Ansichtszustand.

Es gibt Situationen, in denen es angebracht ist, den Ansichtszustand zu deaktivieren, insbesondere um die Anwendungsleistung zu verbessern. Wenn Sie beispielsweise eine Datenbankanforderung in ein Serversteuerelement laden, legen Sie diese Eigenschaft auf fest false. Andernfalls verschwendet der Prozessor die Zeit beim Laden des Ansichtszustands in das Serversteuerelement, das nur von der Datenbankabfrage überschrieben wird. falseWenn EnableViewState ist, können Sie den Steuerelementzustand verwenden, um Eigenschafteninformationen beizubehalten, die für ein Steuerelement spezifisch sind und nicht wie die Ansichtszustandseigenschaft deaktiviert werden können. Weitere Informationen zum Unterschied zwischen dem Steuerelementzustand und dem Ansichtszustand finden Sie unter Control State vs. View State Example.

Informationen zum deklarativen Aktivieren oder Deaktivieren des Ansichtszustands für eine ASP.NET Seite finden Sie unter @ Page.

Gilt für:

Weitere Informationen