Control.LoadControlState(Object) Methode

Definition

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

Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde.

protected public:
 virtual void LoadControlState(System::Object ^ savedState);
protected internal virtual void LoadControlState(object savedState);
abstract member LoadControlState : obj -> unit
override this.LoadControlState : obj -> unit
Protected Friend Overridable Sub LoadControlState (savedState As Object)

Parameter

savedState
Object

Ein Object Wert, der den zu wiederherstellenden Steuerelementstatus darstellt.

Beispiele

Im folgenden Codebeispiel wird die methode LoadControlState in einem benutzerdefinierten ASP.NET-Steuerelement außer Kraft gesetzt. Wenn diese Methode aufgerufen wird, bestimmt sie, ob der Steuerelementstatus zuvor für das Steuerelement gespeichert wurde, und legt in diesem Fall die interne Eigenschaft currentIndex auf den gespeicherten Wert fest.

Die OnInit Methode wird überschrieben, um die RegisterRequiresControlState Methode aufzurufen Page , um anzugeben, dass das benutzerdefinierte Steuerelement den Steuerelementstatus verwendet.

public class Sample : Control {
    private int currentIndex = 0;
   
    protected override void OnInit(EventArgs e) {
        Page.RegisterRequiresControlState(this);
        base.OnInit(e);
    }

    protected override object SaveControlState() {
        return currentIndex != 0 ? (object)currentIndex : null;
    }

    protected override void LoadControlState(object state) {
        if (state != null) {
            currentIndex = (int)state;
        }
    }
}

Class Sample
  Inherits Control
  
  Dim currentIndex As Integer
  
      Protected Overrides Sub OnInit(ByVal e As EventArgs)
          Page.RegisterRequiresControlState(Me)
          currentIndex = 0
          MyBase.OnInit(e)
      End Sub
  
      Protected Overrides Function SaveControlState() As Object
          If currentIndex <> 0 Then
              Return CType(currentIndex, Object)
          Else
              Return Nothing
          End If
      End Function
  
      Protected Overrides Sub LoadControlState(ByVal state As Object)
          If (state <> Nothing) Then
              currentIndex = CType(state, Integer)
          End If
      End Sub
  
End Class

Hinweise

Überschreiben Sie diese Methode, wenn Sie angeben müssen, wie ein benutzerdefiniertes Serversteuerelement den Steuerelementzustand wiederherstellen soll. Weitere Informationen finden Sie unter ASP.NET Übersicht über die Zustandsverwaltung.

Gilt für:

Weitere Informationen