語言

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 請求提交，則查詢字串參數不會被保留。

適用於

另請參閱