Control.LoadControlState(Object) 메서드

정의

SaveControlState() 메서드에서 저장한 이전 페이지 요청에서 컨트롤 상태 정보를 복원합니다.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

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)

매개 변수

savedState
Object

복원할 컨트롤 상태를 나타내는 Object입니다.An Object that represents the control state to be restored.

예제

다음 코드 예제에서는 사용자 지정 ASP.NET 컨트롤의 LoadControlState 메서드를 재정의 합니다.The following code example overrides the LoadControlState method in a custom ASP.NET control. 이 메서드를 호출 하면 컨트롤 상태가 이전에 컨트롤에 대해 저장 되었는지 여부를 확인 하 고, 해당 하는 경우 내부 속성 currentIndex를 저장 된 값으로 설정 합니다.When this method is invoked, it determines whether control state was previously saved for the control and, if so, sets the internal property currentIndex to the saved value.

OnInit 메서드는 사용자 지정 컨트롤이 컨트롤 상태를 사용 한다는 것을 나타내기 위해 PageRegisterRequiresControlState 메서드를 호출 하도록 재정의 됩니다.The OnInit method is overridden to call the RegisterRequiresControlState method on the Page to indicate that the custom control uses control state.

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

설명

사용자 지정 서버 컨트롤에서 컨트롤 상태를 복원 하는 방법을 지정 해야 하는 경우이 메서드를 재정의 합니다.Override this method when you need to specify how a custom server control restores its control state. 자세한 내용은 ASP.NET 상태 관리 개요합니다.For more information, see ASP.NET State Management Overview.

적용 대상

추가 정보