Share via

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 送信された場合、クエリ文字列パラメーターは保持されません。

適用対象

こちらもご覧ください