Control.LoadControlState(Object) Methode

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.

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.

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, das den wiederherzustellenden Steuerelementzustand darstellt.

Beispiele

Im folgenden Codebeispiel wird die LoadControlState -Methode 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 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 Steuerelementzustand 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 seinen Steuerelementstatus wiederhergestellt. Weitere Informationen finden Sie unter übersicht über ASP.NET Zustandsverwaltung.

Gilt für:

Produkt	Versionen
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Teilen über