WebPartPersonalization.ToggleScope 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
public:
virtual void ToggleScope();public virtual void ToggleScope();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()在尝试从 Shared 范围切换到 User 范围时，当前用户不具有进入 Shared 范围的用户功能。
- 或 -
WebPartPersonalization 实例尚未完成初始化。
- 或 -
关联的 Page 的 WebPartManager 实例为 null。
- 或 -
Request 控件的关联 WebPartManager 实例的 Page 属性的值是 null。
进行了切换到未在 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 页面，则不会保留查询字符串参数。
适用于
| 产品 | 版本 |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
