通过

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 返回到当前执行页。

如果在导出或导入 Web 部件控件时调用此方法，则不执行任何操作。

如果对通过 POST 请求提交的页面发生切换范围请求，则在传输过程中将保留任何查询字符串值;如果通过请求提交 GET 页面，则不会保留查询字符串参数。

适用于

另请参阅