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

適用対象

こちらもご覧ください