Control.EnableViewState Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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 Ansichtsstatus für ein Steuerelement ist aktiviert, wenn alle 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 Zeiten, 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 die Prozessorzeit das Laden des Ansichtszustands in das Serversteuerelement, das nur von der Datenbankabfrage überschrieben wird. Wenn EnableViewState ist false, 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 Kontrollzustand und Ansichtszustand finden Sie unter Steuerelementstatus und Ansichtszustandsbeispiel.

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

Gilt für:

Weitere Informationen