Control.EnableViewState Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Boolean

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

Attribute: ThemeableAttribute

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:

Die EnableViewState -Eigenschaft für die Seite ist auf truefestgelegt.
Die EnableViewState -Eigenschaft für das -Steuerelement ist auf truefestgelegt.
Die ViewStateMode -Eigenschaft für das Steuerelement ist auf Enabled festgelegt oder erbt die Enabled Einstellung.

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:

Freigeben über