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

適用於

另請參閱