다음을 통해 공유

WebPartPersonalization.Load 메서드

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls.WebParts
어셈블리:
System.Web.dll

개인 설정을 초기화합니다.

protected:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationScope Load();
protected virtual System.Web.UI.WebControls.WebParts.PersonalizationScope Load ();
abstract member Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope

반환

PersonalizationScope

부모 PersonalizationScope의 WebPartManager 인스턴스입니다.

예외

InvalidOperationException

개인 설정이 활성화되지 않은 상태 즉, Enabled가 false인 상태에서 이 메서드를 호출한 경우

또는

연결된 Page의 WebPartManager 속성 값이 null인 경우

또는

Request 컨트롤의 연결된 WebPartManager 인스턴스에 대한 Page 속성의 값이 null인 경우

ProviderException

페이지 태그나 ProviderName 속성에 공급자가 명시적으로 설정되어 있지만 공급자를 찾을 수 없는 경우

또는

개인 설정 상태 데이터를 포함하는 개체가 null인 경우

ArgumentException

데이터를 로드하고 역직렬화하는 동안 문제가 발생한 경우

또는

구성 파일에서 개인 설정 공급자의 정의에 오류가 발생한 경우

ConfigurationErrorsException

기본 공급자를 찾을 수 없거나 개인 설정 공급자를 초기화하는 동안 문제가 발생하여 내부 개인 설정 공급자를 초기화하지 못한 경우

설명

부모 WebPartManager 컨트롤을 대신하여 개인 설정 정보를 초기화하기 위한 주요 진입점입니다. 이 메서드는 부모 WebPartManager 컨트롤의 OnInit 메서드 중에 호출됩니다. 일반적으로 부모 WebPartManager 컨트롤에서 개인 설정을 사용하지 않도록 설정한 경우 이 메서드는 호출되지 않습니다.

이 메서드를 진행하는 동안 다음과 같은 초기화가 발생합니다.

  • 기본 개인 설정 공급자 또는 페이지 태그 또는 속성에 WebPartManager 표시된 사용자 지정 공급자에 대한 참조를 ProviderName 가져옵니다.

  • 공급자는 현재 실행 중인 사용자에 대한 사용자 기능(DetermineUserCapabilities)을 확인하기 위해 호출됩니다.

  • 현재 페이지/사용자/범위 조합에 대한 개인 설정 상태는 공급자(LoadPersonalizationState)에 의해 기본 데이터 저장소에서 로드되고 인스턴스 내에 WebPartPersonalization 저장됩니다.

  • 현재 페이지/사용자/범위에 대한 개인 설정 범위는 공급자(DetermineInitialScope)에 의해 결정됩니다. 이 결정의 결과는 속성 값 InitialScope 과 다를 수 있습니다.

이 메서드에서 반환된 범위 값은 속성의 값 Scope 으로 사용됩니다.

참고

InvalidOperationException 개인 설정이 활성화되지 않아서 예외는 메서드가 Load 직접 호출된 경우에만 발생합니다. ASP.NET 구현에서 내부 도우미 메서드는 실제로 호출되어 로드를 수행하고, 페이지에 대해 개인 설정이 활성화되지 않은 경우 이 도우미 메서드는 자동으로 반환됩니다.

적용 대상

추가 정보