다음을 통해 공유


WebPartPersonalization.Load 메서드

정의

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

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 부모WebPartManager에 대한 인스턴스입니다.

예외

이 메서드는 개인 설정이 활성화되지 않은 경우 호출됩니다(Enabled 같음 false).

-또는-

연결된 속성의 Page 값은 .입니다null.WebPartManager

-또는-

컨트롤의 Request 연결된 Page 인스턴스에 있는 WebPartManager 속성 값은 null.

공급자가 페이지 태그 또는 ProviderName 속성에서 명시적으로 설정되었으며 공급자를 찾을 수 없습니다.

-또는-

개인 설정 상태 데이터를 포함하는 개체는 .입니다 null.

데이터를 로드하고 역직렬화하는 동안 문제가 발생했습니다.

-또는-

구성 파일의 개인 설정 공급자 정의에서 오류가 발생했습니다.

기본 공급자를 찾을 수 없거나 개인 설정 공급자를 초기화하는 동안 오류가 발생하여 기본 개인 설정 공급자를 초기화하지 못했습니다.

설명

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

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

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

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

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

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

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

메모

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

적용 대상

추가 정보