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

Boolean

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

Attribute

Beispiele

Im folgenden Beispiel wird die EnableViewState -Eigenschaft auf false legt.

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 Serversteuersystem, seinen Zustand über HTTP-Anforderungen hinweg zu verwalten. 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 Serversteuer steuerelements ist die Akkumulation aller seiner Eigenschaftswerte. Um diese Werte über HTTP-Anforderungen hinweg zu speichern, verwendet ASP.NET eine Instanz der -Klasse, StateBag um die Eigenschaftswerte zu speichern. Die Werte werden dann als Variable an ein ausgeblendetes Feld übergeben, wenn nachfolgende Anforderungen verarbeitet werden. Weitere Informationen zum Ansichtszustand finden Sie unter ASP.NET Übersicht über den Ansichtszustand.

Manchmal ist es sinnvoll, den Ansichtszustand zu deaktivieren, insbesondere um die Anwendungsleistung zu verbessern. Wenn Sie z. B. eine Datenbankanforderung in ein Serversteuer steuerelement laden, legen Sie diese Eigenschaft auf false fest. Wenn sie dies nicht tun, verschwendet die Prozessorzeit das Laden des Ansichtszustands in das Serversteuersystem, das nur von der Datenbankabfrage überschrieben wird. Wenn ist, können Sie den Steuerelementzustand verwenden, um Eigenschafteninformationen dauerhaft zu erhalten, die für ein Steuerelement spezifisch sind und nicht wie die Ansichtszustandseigenschaft EnableViewState false deaktiviert werden können. Weitere Informationen zum Unterschied zwischen steuerelement- und 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 auf @ der Seite.

Gilt für

Siehe auch