Control.EnableViewState Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält.
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 lautet true.
- Attribute
Beispiele
Im folgenden Beispiel wird die EnableViewState Eigenschaft auf 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 Ansichtszustand ermöglicht es einem Serversteuerelement, seinen Zustand über HTTP-Anforderungen hinweg aufrechtzuerhalten. Der Ansichtszustand für ein Steuerelement ist aktiviert, wenn alle folgenden Bedingungen erfüllt sind:
Die EnableViewState Eigenschaft für die Seite ist auf
true.Die EnableViewState Eigenschaft für das Steuerelement ist auf
true.Die ViewStateMode Eigenschaft für das Steuerelement ist auf Enabled die Einstellung festgelegt oder erbt sie Enabled .
Weitere Informationen finden Sie in den Ausführungen zur ViewStateMode-Eigenschaft.
Der Ansichtszustand eines Serversteuerelements ist die Anhäufung aller Eigenschaftswerte. Um diese Werte über HTTP-Anforderungen hinweg beizubehalten, verwendet ASP.NET eine Instanz der Klasse zum Speichern der StateBag Eigenschaftswerte. 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.
Es gibt Situationen, in denen es sinnvoll 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 false. Wenn Sie dies nicht tun, wird die Prozessorzeit beim Laden des Ansichtszustands in das Serversteuerelement verschwendet, das nur von der Datenbankabfrage außer Kraft gesetzt wird. Wenn EnableViewState ja false, können Sie den Steuerelementstatus 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 Steuerelementstatus 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 unter @Page.