PageStatePersister.ControlState Eigenschaft

Definition

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

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 PairSecond 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: