PersonalizationDictionary

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

PersonalizationDictionary クラス

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

特定のカスタム データが User スコープまたは Shared スコープのいずれかでパーソナル化できると見なされるかどうかを示す、基本評価規則をカプセル化します。

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

Visual Basic (宣言)

Public Class PersonalizationDictionary
    Implements IDictionary, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As PersonalizationDictionary

C#

public class PersonalizationDictionary : IDictionary,
 ICollection, IEnumerable

C++

public ref class PersonalizationDictionary
 : IDictionary, ICollection, IEnumerable

J#

public class PersonalizationDictionary implements
 IDictionary, ICollection, 
    IEnumerable

JScript

public class PersonalizationDictionary implements
 IDictionary, ICollection, 
    IEnumerable

解説

PersonalizationDictionary インスタンスは、パーソナル化スコープおよびオブジェクト値から構成される PersonalizationEntry オブジェクトのコレクションです。これらのエントリには、PersonalizationDictionary オブジェクト内でキーが割り当てられています。

ページのスコープに関係なく、System.Web.UI.WebControls.WebParts.IPersonalizable.Save メソッドを使用してすべてのプロパティをディクショナリに追加することをお勧めします。.NET Framework は、適切な方法で情報を保存します。たとえば、ページが Shared スコープ内にある場合、共有データが保存されます。しかし、Web パーツの値が保存される場合、ページが User スコープ内にある場合、および WebPart コントロールが Shared スコープのページと共に追加された場合は、共有プロパティは保存されません。

.NET Framework のセキュリティ

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

継承階層

System.Object
  System.Web.UI.WebControls.WebParts.PersonalizationDictionary

スレッド セーフ

この型の 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

参照

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

PersonalizationDictionary コンストラクタ ()

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New PersonalizationDictionary

C#

public PersonalizationDictionary ()

C++

public:
PersonalizationDictionary ()

J#

public PersonalizationDictionary ()

JScript

public function PersonalizationDictionary ()

解説

このコンストラクタは、空のディクショナリを初期化します。ディクショナリでは、キー値の大文字と小文字が区別されません。

プラットフォーム

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

参照

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

PersonalizationDictionary コンストラクタ (Int32)

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

指定されたパラメータを使用して、PersonalizationDictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    initialSize As Integer _
)

Visual Basic (使用法)

Dim initialSize As Integer

Dim instance As New PersonalizationDictionary(initialSize)

C#

public PersonalizationDictionary (
    int initialSize
)

C++

public:
PersonalizationDictionary (
    int initialSize
)

J#

public PersonalizationDictionary (
    int initialSize
)

JScript

public function PersonalizationDictionary (
    initialSize : int
)

パラメータ

initialSize

ディクショナリに格納されるエントリ数の予測値。

解説

このコンストラクタは、ディクショナリに格納されるエントリ数の予測値に基づいて、空のディクショナリを初期化します。ディクショナリでは、キー値の大文字と小文字が区別されません。

プラットフォーム

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

参照

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

PersonalizationDictionary コンストラクタ

PersonalizationDictionary クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
PersonalizationDictionary ()	PersonalizationDictionary クラスの新しいインスタンスを初期化します。
PersonalizationDictionary (Int32)	指定されたパラメータを使用して、PersonalizationDictionary クラスの新しいインスタンスを初期化します。

参照

関連項目

PersonalizationDictionary クラス
PersonalizationDictionary メンバ
System.Web.UI.WebControls.WebParts 名前空間

PersonalizationDictionary プロパティ

パブリック プロパティ

	名前	説明
	Count	ディクショナリ内のエントリの数を取得します。
	IsFixedSize	パーソナル化ディクショナリが固定サイズかどうかを取得します。
	IsReadOnly	パーソナル化ディクショナリが読み取り専用かどうかを取得します。
	IsSynchronized	パーソナル化ディクショナリの同期がとられているかどうかを取得します。
	Item	パーソナル化ディクショナリ内のエントリを取得または設定します。
	Keys	パーソナル化ディクショナリのキーを含んでいる ICollection オブジェクトへの参照を取得します。
	SyncRoot	パーソナル化ディクショナリへのアクセスを同期するために使用できるオブジェクトを取得します。
	Values	パーソナル化ディクショナリ内の値を含んでいる ICollection オブジェクトへの参照を取得します。

明示的インターフェイスの実装

	名前	説明
	System.Collections.IDictionary.Item	PersonalizationDictionary クラスの IDictionary.Item プロパティ値を取得または設定します。

参照

関連項目

PersonalizationDictionary クラス
System.Web.UI.WebControls.WebParts 名前空間
SqlPersonalizationProvider
IDictionary
ICollection

その他の技術情報

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

PersonalizationDictionary メソッド

パブリック メソッド

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

	名前	説明
	Add	パーソナル化エントリを、パーソナル化ディクショナリに追加します。
	Clear	現在の PersonalizationDictionary のオブジェクトからすべてのカスタム状態情報を削除します。
	Contains	同じキーを持つ特定のカスタム状態情報が、パーソナル化ディクショナリに含まれているかどうかを示す値を返します。
	CopyTo	パーソナル化ディクショナリの状態エントリを DictionaryEntry インスタンスとして指定した配列にコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	パーソナル化ディクショナリ内のエントリを反復処理するために使用できる列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	指定したキーに基づいて、カスタム状態エントリを削除します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Collections.ICollection.CopyTo	PersonalizationDictionary クラスの ICollection.CopyTo メソッドを実装します。
	System.Collections.IDictionary.Add	PersonalizationDictionary クラスの IDictionary.Add メソッドを実装します。
	System.Collections.IDictionary.Contains	PersonalizationDictionary クラスの IDictionary.Contains メソッドを実装します。
	System.Collections.IDictionary.Remove	PersonalizationDictionary クラスの IDictionary.Remove メソッドを実装します。
	System.Collections.IEnumerable.GetEnumerator	PersonalizationDictionary クラスの IEnumerable.GetEnumerator メソッドを実装します。

参照

関連項目

PersonalizationDictionary クラス
System.Web.UI.WebControls.WebParts 名前空間
SqlPersonalizationProvider
IDictionary
ICollection

その他の技術情報

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

PersonalizationDictionary メンバ

特定のカスタム データが User スコープまたは Shared スコープのいずれかでパーソナル化できると見なされるかどうかを示す、基本評価規則をカプセル化します。

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

パブリック コンストラクタ

	名前	説明
	PersonalizationDictionary	オーバーロードされます。 PersonalizationDictionary クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Count	ディクショナリ内のエントリの数を取得します。
	IsFixedSize	パーソナル化ディクショナリが固定サイズかどうかを取得します。
	IsReadOnly	パーソナル化ディクショナリが読み取り専用かどうかを取得します。
	IsSynchronized	パーソナル化ディクショナリの同期がとられているかどうかを取得します。
	Item	パーソナル化ディクショナリ内のエントリを取得または設定します。
	Keys	パーソナル化ディクショナリのキーを含んでいる ICollection オブジェクトへの参照を取得します。
	SyncRoot	パーソナル化ディクショナリへのアクセスを同期するために使用できるオブジェクトを取得します。
	Values	パーソナル化ディクショナリ内の値を含んでいる ICollection オブジェクトへの参照を取得します。

パブリック メソッド

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

	名前	説明
	Add	パーソナル化エントリを、パーソナル化ディクショナリに追加します。
	Clear	現在の PersonalizationDictionary のオブジェクトからすべてのカスタム状態情報を削除します。
	Contains	同じキーを持つ特定のカスタム状態情報が、パーソナル化ディクショナリに含まれているかどうかを示す値を返します。
	CopyTo	パーソナル化ディクショナリの状態エントリを DictionaryEntry インスタンスとして指定した配列にコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	パーソナル化ディクショナリ内のエントリを反復処理するために使用できる列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	指定したキーに基づいて、カスタム状態エントリを削除します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Collections.ICollection.CopyTo	PersonalizationDictionary クラスの ICollection.CopyTo メソッドを実装します。
	System.Collections.IDictionary.Add	PersonalizationDictionary クラスの IDictionary.Add メソッドを実装します。
	System.Collections.IDictionary.Contains	PersonalizationDictionary クラスの IDictionary.Contains メソッドを実装します。
	System.Collections.IDictionary.Remove	PersonalizationDictionary クラスの IDictionary.Remove メソッドを実装します。
	System.Collections.IEnumerable.GetEnumerator	PersonalizationDictionary クラスの IEnumerable.GetEnumerator メソッドを実装します。
	System.Collections.IDictionary.Item	PersonalizationDictionary クラスの IDictionary.Item プロパティ値を取得または設定します。

参照

関連項目

PersonalizationDictionary クラス
System.Web.UI.WebControls.WebParts 名前空間
SqlPersonalizationProvider
IDictionary
ICollection

その他の技術情報

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