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

こちらもご覧ください

• WebPartPersonalization
• ASP.NET Web パーツ コントロール
• Web パーツのパーソナル化の概要
• チュートリアル: ユーザー コントロールを使用した Web パーツのパーソナル化の実装
• Web パーツのパーソナル化