PersonalizationScope 列挙型

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

WebPartManager オブジェクトのパーソナル化スコープ、または Web パーツ コントロールのプロパティに適用されるパーソナル化スコープを示します。

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
継承
Object
ValueType
Enum
PersonalizationScope

フィールド

名前 値 説明
User 0

WebPartManager コントロールのスコープを参照する場合、Userスコープは、ユーザー固有のパーソナル化データと、すべてのユーザーに適用されるパーソナル化データが、ページ上のすべてのカスタマイズ可能なコントロールに対して読み込まれることを意味します。 ユーザー固有のパーソナル化データのみをページに保存できます。
Web パーツ コントロール プロパティに関連付けられているスコープを参照する場合、 User スコープは、プロパティが、 Shared スコープ内のページで実行しているときに、すべてのユーザーに適用できるデータのみを読み込んで格納できることを示します。 ただし、プロパティのコントロールが User スコープ内のページで実行されている場合、プロパティのユーザーごとのデータとすべてのユーザー データが読み込まれ、マージされます。 ただし、この場合、ページがスコープ スコープで実行されている場合は、ユーザーごとのデータ User 保存されます。
Shared 1

WebPartManager コントロールのスコープを参照する場合、Sharedスコープとは、個人用設定データがページ上のすべてのカスタマイズ可能なコントロールのすべてのユーザーに適用され、ページに保存することも可能であることを意味します。
Web パーツ コントロール プロパティに関連付けられているスコープを参照する場合、 Shared スコープは、プロパティが通常、すべてのユーザーに関連付けられているデータの読み込みまたは保存のみを許可することを示します。

例

次の例では、 PersonalizationScope 列挙体の使用を示します。

if (_manager.Personalization.Scope == PersonalizationScope.Shared)
{
    TextBox2.Text = "Shared Scope";
}
else
    TextBox2.Text = "User Scope";

注釈

パーソナル化スコープは Web パーツのパーソナル化の重要な概念であり、ページが WebPartManager コントロールを介して実行されているスコープ、コントロールの各プロパティに関連付けられているスコープ、およびコントロールがページに追加された方法など、他の設定と緊密に統合されています。 パーソナル化スコープの詳細については、「 Web パーツのパーソナル化の概要」を参照してください。

パーソナル化スコープとは、さまざまなユーザー セットにパーソナル化データを適用する方法を指します。 一部のパーソナル化データは、ページ上の特定のユーザーとコントロールにのみ適用されます。 その他の個人用設定データは、サイトを表示するすべてのユーザーに適用されます。 パーソナル化スコープは、取得して表示する必要があるデータのセットを示すために、パーソナル化のさまざまな領域で使用されます。

ページがパーソナル化スコープ Shared で実行されている場合、これは、コントロールを表示するすべてのユーザーに適用できる特定のコントロールのパーソナル化データのみを読み込む必要があることを示します。 現在実行中のユーザーの権限に応じて、この広範に適用されるデータを変更してデータ ストアに保存することもできます。 Userパーソナル化スコープでページが実行されている場合は、現在実行中のユーザーに基づいてコントロールのパーソナル化データを保存して読み込む必要があることを示します。 通常、これはユーザー固有のデータをコントロールに読み込んで保存できるのに対し、広く適用できるデータ (または共有データ) はコントロールでのみ表示できることを意味します。

パーソナル化の高度なライフ サイクルを管理する WebPartManager コントロールは、2 つのパーソナル化スコープのいずれかで実行されます。

適用対象