WebPartPersonalization.ChangeScope メソッド

.NET Framework クラス ライブラリ リファレンス

WebPartPersonalization.ChangeScope メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在のページの PersonalizationScope インスタンスを、指定されたスコープに変更します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 ChangeScope ( _
    scope As PersonalizationScope _
)

Visual Basic (使用法)

Dim scope As PersonalizationScope

Me.ChangeScope(scope)

C#

protected virtual void ChangeScope (
    PersonalizationScope scope
)

C++

protected:
virtual void ChangeScope (
    PersonalizationScope scope
)

J#

protected void ChangeScope (
    PersonalizationScope scope
)

JScript

protected function ChangeScope (
    scope : PersonalizationScope
)

パラメータ

scope

現在のページの新しいパーソナル化スコープ。

例外

例外の種類	条件
InvalidOperationException	User スコープから Shared スコープに切り替えようとしたときに、現在のユーザーに Shared スコープを入力するためのユーザー機能がありませんでした。
ArgumentOutOfRangeException	scope が有効な PersonalizationScope 列挙体のメンバではありません。

解説

このメソッドは、現在実行中のページのパーソナル化スコープを、newScope パラメータによって指定された新しいスコープに変更します。このメソッドは、パブリック ToggleScope メソッドによって呼び出されるプロテクト ヘルパー メソッドです。このプロテクト メソッドは、切り替えるスコープが 3 つ以上存在する場合に将来の機能拡張を処理するために存在します。

現在のスコープおよび newScope が同じ値の場合、このメソッドでは操作は実行されません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartPersonalization クラス
WebPartPersonalization メンバ
System.Web.UI.WebControls.WebParts 名前空間
WebPartPersonalization クラス
その他の技術情報
ASP.NET Web パーツ ページ
Web パーツのパーソナル化の概要
チュートリアル : ユーザー コントロールに Web パーツ パーソナル化を実装する
Web パーツのパーソナル化