WebPartPersonalization.ToggleScope 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

현재 페이지의 개인 설정 범위를 User 전환합니다 SharedSharedUser.

public:
 virtual void ToggleScope();

public virtual void ToggleScope();

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

Public Overridable Sub ToggleScope ()

예외

InvalidOperationException

범위에서 범위로 전환하려고 할 때 현재 사용자에게 범위를 입력 Shared 할 수 있는 UserShared 사용자 기능이 없습니다.

-또는-

인스턴스가 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 웹 파트 컨트롤
• 웹 파트 개인 설정 개요
• 연습: 사용자 컨트롤을 사용하여 웹 파트 개인 설정 구현
• 웹 파트 개인 설정