PageStatePersister.ControlState 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 ein Objekt ab, das die Daten darstellt, die Steuerelemente, die sich im aktuellen Page-Objekt befinden, über HTTP-Anforderungen an den Webserver hinweg beibehalten, oder legt dieses fest.

public:
 property System::Object ^ ControlState { System::Object ^ get(); void set(System::Object ^ value); };

public object ControlState { get; set; }

member this.ControlState : obj with get, set

Public Property ControlState As Object

Eigenschaftswert

Object

Ein Objekt mit Ansichtszustandsdaten.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine von der PageStatePersister -Klasse abgeleitete Klasse die ControlState -Eigenschaft initialisiert. In diesem Beispiel wurde die ControlState -Eigenschaft dem Second Feld eines Pair -Objekts zugewiesen und mithilfe der ObjectStateFormatter -Klasse serialisiert. Wenn die Load -Methode aufgerufen wird, wird die ObjectStateFormatter -Klasse verwendet, um den Ansichtszustand zu deserialisieren und Zustandsinformationen zu steuern, und die ControlState Eigenschaft wird aus dem Feld des resultierenden Pair Second Objekts initialisiert. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die PageStatePersister-Klasse bereitgestellt wird.

//
// Load ViewState and ControlState.
//
public override void Load()
{
    Stream stateStream = GetSecureStream();

    // Read the state string, using the StateFormatter.
    StreamReader reader = new StreamReader(stateStream);

    IStateFormatter formatter = this.StateFormatter;
    string fileContents = reader.ReadToEnd();

    // Deserilize returns the Pair object that is serialized in
    // the Save method.
    Pair statePair = (Pair)formatter.Deserialize(fileContents);

    ViewState = statePair.First;
    ControlState = statePair.Second;
    reader.Close();
    stateStream.Close();
}

'
' Load ViewState and ControlState.
'
Public Overrides Sub Load()

    Dim stateStream As Stream
    stateStream = GetSecureStream()

    ' Read the state string, using the StateFormatter.
    Dim reader As New StreamReader(stateStream)

    Dim serializedStatePair As String
    serializedStatePair = reader.ReadToEnd
    Dim statePair As Pair

    Dim formatter As IStateFormatter
    formatter = Me.StateFormatter

    ' Deserilize returns the Pair object that is serialized in
    ' the Save method.      
    statePair = CType(formatter.Deserialize(serializedStatePair), Pair)

    ViewState = statePair.First
    ControlState = statePair.Second
    reader.Close()
    stateStream.Close()
End Sub

Hinweise

Der Steuerelementzustand ist ein Objekt, das aus kritischen Ansichtszustandsdaten besteht, die Webserversteuerelemente benötigen, um zu funktionieren, und ist in einem separaten Objekt als normale Ansichtszustandsinformationen enthalten. Steuerungszustandsdaten sind nicht betroffen, wenn der Ansichtszustand auf der Page Ebene deaktiviert ist, es sind jedoch zusätzliche Implementierungsschritte erforderlich. Weitere Informationen zur Verwendung des ViewState Eigenschaften- und Steuerelementzustands beim Entwickeln von Steuerelementen finden Sie unter Entwickeln von benutzerdefinierten ASP.NET Serversteuerelementen.

Gilt für:

Freigeben über