PersonalizationState

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

PersonalizationState クラス

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

ページのパーソナル化データを表す基本機能を定義します。

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

Visual Basic (宣言)

Public MustInherit Class
 PersonalizationState

Visual Basic (使用法)

Dim instance As PersonalizationState

C#

public abstract class PersonalizationState

C++

public ref class PersonalizationState abstract

J#

public abstract class PersonalizationState

JScript

public abstract class PersonalizationState

解説

この基本クラスから派生するクラスには、パーソナル化データの管理、適用、および抽出のための実際の実装が格納されています。WebPartPersonalization クラスは、PersonalizationState への参照を使ってパーソナル化状態を利用します。

開発者がカスタムの PersonalizationState の実装を記述する場合には、カスタムの PersonalizationProvider も同様に記述する必要があります。PersonalizationProvider のインスタンスによって、PersonalizationState のインスタンスが作成および使用されます。

継承時の注意 派生クラスは、常に派生コンストラクタから基本クラス コンストラクタを呼び出す必要があります。

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
  System.Web.UI.WebControls.WebParts.PersonalizationState

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

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

PersonalizationState コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

PersonalizationState クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New ( _
    webPartManager As WebPartManager _
)

Visual Basic (使用法)

Dim webPartManager As WebPartManager

Dim instance As New PersonalizationState(webPartManager)

C#

protected PersonalizationState (
    WebPartManager webPartManager
)

C++

protected:
PersonalizationState (
    WebPartManager^ webPartManager
)

J#

protected PersonalizationState (
    WebPartManager webPartManager
)

JScript

protected function PersonalizationState (
    webPartManager : WebPartManager
)

パラメータ

webPartManager

パーソナル化データが存在する Web パーツ コントロールを管理する WebPartManager。

例外

例外の種類	条件
ArgumentNullException	webPartManager パラメータが null 参照 (Visual Basic では Nothing) です。

解説

このコンストラクタによって作成されるオブジェクトは、指定された WebPartManager コントロールによって管理される Web パーツ コントロールの状態を管理します。

実装時の注意 派生クラスは、常に派生コンストラクタから基本クラス コンストラクタを呼び出す必要があります。

プラットフォーム

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

参照

関連項目
PersonalizationState クラス
PersonalizationState メンバ
System.Web.UI.WebControls.WebParts 名前空間

PersonalizationState プロパティ

パブリック プロパティ

	名前	説明
	IsDirty	パーソナル化情報が変更されたかどうかを示す値を取得します。
	IsEmpty	オーバーライドされると、状態のインスタンスによってパーソナル化状態が抽出されたかどうかを示す値を取得します。
	WebPartManager	パーソナル化状態のインスタンスに現在関連付けられている WebPartManager コントロールへの参照を取得します。

参照

関連項目

PersonalizationState クラス
System.Web.UI.WebControls.WebParts 名前空間
PersonalizationProvider クラス

その他の技術情報

ASP.NET Web パーツ ページ
Web パーツのパーソナル化の概要
チュートリアル : ユーザー コントロールに Web パーツ パーソナル化を実装する
Web パーツのパーソナル化

PersonalizationState メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	ApplyWebPartManagerPersonalization	オーバーライドされると、パーソナル化データが、パーソナル化状態のインスタンスに関連付けられている WebPartManager コントロールに適用されます。
	ApplyWebPartPersonalization	オーバーライドされると、パーソナル化データが、指定された Web パーツ コントロールに適用されます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	ExtractWebPartManagerPersonalization	オーバーライドされると、現在のパーソナル化状態に関連付けられた WebPartManager コントロールからパーソナル化情報が抽出されます。
	ExtractWebPartPersonalization	オーバーライドされると、パーソナル化データが、指定された Web パーツ コントロールから抽出されます。
	GetAuthorizationFilter	指定した Web パーツ コントロールの承認フィルタを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetWebPartDirty	オーバーライドされると、Web パーツ コントロールが変更されたことをマークします。
	SetWebPartManagerDirty	オーバーライドされると、関連する WebPartManager コントロールが変更されたことをマークします。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	SetDirty	現在のパーソナル化状態が変更されたことをマークします。
	ValidateWebPart	指定した Web パーツ コントロールが有効であるかを検証します。

参照

関連項目

PersonalizationState クラス
System.Web.UI.WebControls.WebParts 名前空間
PersonalizationProvider クラス

その他の技術情報

ASP.NET Web パーツ ページ
Web パーツのパーソナル化の概要
チュートリアル : ユーザー コントロールに Web パーツ パーソナル化を実装する
Web パーツのパーソナル化

PersonalizationState メンバ

ページのパーソナル化データを表す基本機能を定義します。

PersonalizationState データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	PersonalizationState	PersonalizationState クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	IsDirty	パーソナル化情報が変更されたかどうかを示す値を取得します。
	IsEmpty	オーバーライドされると、状態のインスタンスによってパーソナル化状態が抽出されたかどうかを示す値を取得します。
	WebPartManager	パーソナル化状態のインスタンスに現在関連付けられている WebPartManager コントロールへの参照を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	ApplyWebPartManagerPersonalization	オーバーライドされると、パーソナル化データが、パーソナル化状態のインスタンスに関連付けられている WebPartManager コントロールに適用されます。
	ApplyWebPartPersonalization	オーバーライドされると、パーソナル化データが、指定された Web パーツ コントロールに適用されます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	ExtractWebPartManagerPersonalization	オーバーライドされると、現在のパーソナル化状態に関連付けられた WebPartManager コントロールからパーソナル化情報が抽出されます。
	ExtractWebPartPersonalization	オーバーライドされると、パーソナル化データが、指定された Web パーツ コントロールから抽出されます。
	GetAuthorizationFilter	指定した Web パーツ コントロールの承認フィルタを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetWebPartDirty	オーバーライドされると、Web パーツ コントロールが変更されたことをマークします。
	SetWebPartManagerDirty	オーバーライドされると、関連する WebPartManager コントロールが変更されたことをマークします。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	SetDirty	現在のパーソナル化状態が変更されたことをマークします。
	ValidateWebPart	指定した Web パーツ コントロールが有効であるかを検証します。

参照

関連項目

PersonalizationState クラス
System.Web.UI.WebControls.WebParts 名前空間
PersonalizationProvider クラス

その他の技術情報

ASP.NET Web パーツ ページ
Web パーツのパーソナル化の概要
チュートリアル : ユーザー コントロールに Web パーツ パーソナル化を実装する
Web パーツのパーソナル化