WebPartPersonalization.ToggleScope 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

현재 페이지의 개인 설정 범위를 User에서 Shared로 또는 Shared에서 User로 전환합니다.

public:
 virtual void ToggleScope();

public virtual void ToggleScope ();

abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unit

Public Overridable Sub ToggleScope ()

예외

InvalidOperationException

Shared 범위에서 User 범위로 전환하려 할 때 Shared 범위에 진입하기 위한 사용자 기능이 현재 사용자에게 없는 경우

또는

WebPartPersonalization 인스턴스의 초기화가 완료되지 않은 경우

또는

연결된 Page의 WebPartManager 인스턴스가 null인 경우

또는

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

ArgumentOutOfRangeException

PersonalizationScope 열거형에 정의되지 않은 범위로 전환하려 한 경우. 기술적으로 이 상황은 발생하지 않습니다.

예제

다음 코드에서는 메서드를 사용하는 방법을 보여 줍니다 ToggleScope . 이 코드는 클래스 설명에 있는 더 큰 코드 샘플의 WebPartPersonalization 일부입니다.

// Allows authorized user to change personalization scope.
protected void Toggle_Scope_Button_Click(object sender, EventArgs e)
{
    if (_manager.Personalization.CanEnterSharedScope)
    {
        _manager.Personalization.ToggleScope();
    }
    
}

' Allows authorized user to change personalization scope.
Protected Sub Toggle_Scope_Button_Click(ByVal sender As Object, ByVal e As EventArgs) 
    If _manager.Personalization.CanEnterSharedScope Then
        _manager.Personalization.ToggleScope()
    End If

End Sub 'Toggle_Scope_Button_Click 

설명

이 메서드는 현재 실행 중인 페이지의 개인 설정 범위를 전환합니다. 범위를 Transfer 전환하면 가 현재 실행 페이지로 돌아갑니다.

이 메서드는 웹 파트 컨트롤의 내보내기 또는 가져오기가 발생하는 동안 호출되는 경우 작업을 수행하지 않습니다.

요청을 통해 POST 제출된 페이지에 대해 토글 범위 요청이 발생하면 전송 중에 쿼리 문자열 값이 유지됩니다. 요청을 통해 GET 페이지를 제출한 경우 쿼리 문자열 매개 변수가 유지되지 않습니다.

추가 정보

• WebPartPersonalization
• 웹 파트 컨트롤 ASP.NET
• 웹 파트 개인 설정 개요
• 연습: 사용자 컨트롤을 사용하여 웹 파트 개인 설정 구현
• 웹 파트 개인 설정