PersonalizationProvider.DetermineInitialScope 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

초기 개인 설정 범위를 Shared 범위로 할지 User 범위로 할지 결정합니다.

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationScope DetermineInitialScope(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, System::Web::UI::WebControls::WebParts::PersonalizationState ^ loadedState);

public virtual System.Web.UI.WebControls.WebParts.PersonalizationScope DetermineInitialScope (System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, System.Web.UI.WebControls.WebParts.PersonalizationState loadedState);

abstract member DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScope

Public Overridable Function DetermineInitialScope (webPartManager As WebPartManager, loadedState As PersonalizationState) As PersonalizationScope

매개 변수

webPartManager

WebPartManager

개인 설정 정보를 관리하는 WebPartManager입니다.

loadedState

PersonalizationState

개인 설정 상태 정보입니다.

반환

PersonalizationScope

현재 개인 설정 범위가 PersonalizationScope인지 User인지 나타내는 Shared입니다.

예외

ArgumentNullException

webPartManager이(가) null인 경우

ArgumentException

webPartManager와 연결된 페이지가 null인 경우

설명

이 메서드는 개인 설정 수명 주기의 앞부분에서 이미 로드된 컨트롤 및 개인 설정 상태 정보에 대한 참조 WebPartManager 를 고려하여 현재 scope 또는 이어야 하는지 SharedUser여부를 결정합니다. 이 정보는 instance 후속 개인 설정 관련 작업에 사용됩니다 WebPartPersonalization .

다음 규칙은 개인 설정 scope 결정하는 데 사용됩니다.

• 범위는 처음에 로 User간주됩니다.

• 현재 실행 중인 사용자 계정이 인증되지 않은 경우 scope 로 Shared설정됩니다.

• 현재 실행 중인 사용자 계정이 인증되면 우선 순위에 따라 추가 처리가 발생합니다.

  • 페이지가 포스트백 모드인 경우 페이지 요청에는 페이지의 이전 렌더링에서 scope 정보가 포함됩니다. 해당 scope 정보가 scope 사용되었음을 나타내는 Shared 경우 scope 로 Shared평가됩니다.

  • 현재 실행 중인 페이지에 컨트롤이 다른 페이지에서 전송된 경우(예: 메서드 호출 Transfer 로 인해 컨트롤 전송이 발생한 경우, 교차 페이지 게시에 대해 이 특정 검사 발생하지 않음) 이전에 실행한 페이지에 WebPartManager instance 있는 경우 scope 이전 WebPartManager instance 속성 값 Personalization.Scope 으로 설정됩니다.

  • 이전 조건이 충족되지 않으면 scope 현재 WebPartManager 컨트롤의 InitialScope 속성 값으로 평가됩니다.

이전 평가가 수행된 후 scope scope 평가 Shared 되면 다음 처리가 수행됩니다.

• 현재 실행 중인 사용자 계정에 기능이 있는 EnterSharedScopeUserCapability 경우 scope 로 설정된 Shared상태로 유지됩니다.

• 현재 실행 중인 사용자 계정에 기능이 없 EnterSharedScopeUserCapability 으면 scope 로 User다시 설정됩니다.

• 모든 이전 scope 평가Shared의 결과가 인 경우 이 결과는 현재 실행 중인 페이지에 숨겨진 필드로 저장됩니다. 이는 페이지가 후속 포스트백 중에 scope 평가를 재생할 수 있는 메커니즘입니다.