SettingsContext

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

SettingsContext クラス

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

設定を保持する場合にプロバイダが使用できるコンテキスト情報を提供します。

名前空間: System.Configuration
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class SettingsContext
    Inherits Hashtable

Visual Basic (使用法)

Dim instance As SettingsContext

C#

[SerializableAttribute] 
public class SettingsContext : Hashtable

C++

[SerializableAttribute] 
public ref class SettingsContext : public
 Hashtable

J#

/** @attribute SerializableAttribute() */ 
public class SettingsContext extends Hashtable

JScript

SerializableAttribute 
public class SettingsContext extends
 Hashtable

解説

SettingsContext クラスは、基本クラスであり、設定プロバイダにコンテキスト情報を提供するためにアプリケーションによって使用されます。このクラスは抽象型ではありませんが、アプリケーションで、SettingsContext クラスを継承してプロバイダの特定の型に追加情報を提供する特殊なクラスを作成することができます。プロパティの書き込み時に、プロバイダはコンテキストの設定を調べることができます。

SettingsContext クラスの主な目的は、SettingsBase クラスと関連するインフラストラクチャを使用する機能を提供することです。SettingsContext クラスは、SettingsBase インスタンスによって格納されるプロパティ データに関する、追加機能固有のコンテキスト情報を提供します。したがって、追加機能固有のコンテキスト情報をサポートする場合に、SettingsContext クラス (または Settings で始まる他のクラス) から派生しなくても、そのクラスに追加情報を簡単に格納できます。

たとえば、ASP.NET は SettingsContext クラスを使用して、SettingsBase インスタンスやユーザーが認証済みと見なされるかどうかを示すプロパティで管理されるデータに関連付けられたユーザー名を渡します。ASP.NET はこの方法で、SettingsContext クラスを使用して、認証済みプロファイルのデータか、匿名プロファイルのデータかを識別します。

継承階層

System.Object
   System.Collections.Hashtable
    System.Configuration.SettingsContext

スレッド セーフ

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

参照

関連項目
SettingsContext メンバ
System.Configuration 名前空間
その他の技術情報
ASP.NET アプリケーションの構成

SettingsContext コンストラクタ

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

SettingsContext クラスのインスタンスを初期化します。

名前空間: System.Configuration
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SettingsContext

C#

public SettingsContext ()

C++

public:
SettingsContext ()

J#

public SettingsContext ()

JScript

public function SettingsContext ()

プラットフォーム

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

参照

関連項目
SettingsContext クラス
SettingsContext メンバ
System.Configuration 名前空間

SettingsContext プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	Hashtable に格納されているキー/値ペアの数を取得します。 ( Hashtable から継承されます。)
	IsFixedSize	Hashtable が固定サイズかどうかを示す値を取得します。 ( Hashtable から継承されます。)
	IsReadOnly	Hashtable が読み取り専用かどうかを示す値を取得します。 ( Hashtable から継承されます。)
	IsSynchronized	Hashtable へのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。 ( Hashtable から継承されます。)
	Item	指定したキーに関連付けられている値を取得または設定します。 ( Hashtable から継承されます。)
	Keys	Hashtable 内のキーを格納している ICollection を取得します。 ( Hashtable から継承されます。)
	SyncRoot	Hashtable へのアクセスを同期するために使用できるオブジェクトを取得します。 ( Hashtable から継承されます。)
	Values	Hashtable 内の値を格納している ICollection を取得します。 ( Hashtable から継承されます。)

プロテクト プロパティ

	名前	説明
	comparer	Hashtable で使用する IComparer を取得または設定します。 ( Hashtable から継承されます。)
	EqualityComparer	Hashtable に使用する IEqualityComparer を取得します。 ( Hashtable から継承されます。)
	hcp	ハッシュ コードを提供できるオブジェクトを取得または設定します。 ( Hashtable から継承されます。)

参照

関連項目

SettingsContext クラス
System.Configuration 名前空間

その他の技術情報

ASP.NET アプリケーションの構成

SettingsContext メソッド

パブリック メソッド

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

	名前	説明
	Add	指定したキーおよび値を持つ要素を Hashtable に追加します。 ( Hashtable から継承されます。)
	Clear	Hashtable からすべての要素を削除します。 ( Hashtable から継承されます。)
	Clone	Hashtable の簡易コピーを作成します。 ( Hashtable から継承されます。)
	Contains	Hashtable に特定のキーが格納されているかどうかを判断します。 ( Hashtable から継承されます。)
	ContainsKey	Hashtable に特定のキーが格納されているかどうかを判断します。 ( Hashtable から継承されます。)
	ContainsValue	Hashtable に特定の値が格納されているかどうかを判断します。 ( Hashtable から継承されます。)
	CopyTo	1 次元の Array インスタンスの指定したインデックスに Hashtable の要素をコピーします。 ( Hashtable から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	Hashtable を反復処理する IDictionaryEnumerator を返します。 ( Hashtable から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	ISerializable インターフェイスを実装し、Hashtable をシリアル化するために必要なデータを返します。 ( Hashtable から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	OnDeserialization	ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントを発生させます。 ( Hashtable から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	指定したキーを持つ要素を Hashtable から削除します。 ( Hashtable から継承されます。)
	Synchronized	Hashtable 用の同期された (スレッド セーフな) ラッパーを返します。 ( Hashtable から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetHash	指定したキーのハッシュ コードを返します。 ( Hashtable から継承されます。)
	KeyEquals	特定の Object を Hashtable 内の特定のキーと比較します。 ( Hashtable から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SettingsContext クラス
System.Configuration 名前空間

その他の技術情報

ASP.NET アプリケーションの構成

SettingsContext メンバ

設定を保持する場合にプロバイダが使用できるコンテキスト情報を提供します。

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

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

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

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	Hashtable に格納されているキー/値ペアの数を取得します。(Hashtable から継承されます。)
	IsFixedSize	Hashtable が固定サイズかどうかを示す値を取得します。(Hashtable から継承されます。)
	IsReadOnly	Hashtable が読み取り専用かどうかを示す値を取得します。(Hashtable から継承されます。)
	IsSynchronized	Hashtable へのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。(Hashtable から継承されます。)
	Item	指定したキーに関連付けられている値を取得または設定します。(Hashtable から継承されます。)
	Keys	Hashtable 内のキーを格納している ICollection を取得します。(Hashtable から継承されます。)
	SyncRoot	Hashtable へのアクセスを同期するために使用できるオブジェクトを取得します。(Hashtable から継承されます。)
	Values	Hashtable 内の値を格納している ICollection を取得します。(Hashtable から継承されます。)

プロテクト プロパティ

	名前	説明
	comparer	Hashtable で使用する IComparer を取得または設定します。(Hashtable から継承されます。)
	EqualityComparer	Hashtable に使用する IEqualityComparer を取得します。(Hashtable から継承されます。)
	hcp	ハッシュ コードを提供できるオブジェクトを取得または設定します。(Hashtable から継承されます。)

パブリック メソッド

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

	名前	説明
	Add	指定したキーおよび値を持つ要素を Hashtable に追加します。 (Hashtable から継承されます。)
	Clear	Hashtable からすべての要素を削除します。 (Hashtable から継承されます。)
	Clone	Hashtable の簡易コピーを作成します。 (Hashtable から継承されます。)
	Contains	Hashtable に特定のキーが格納されているかどうかを判断します。 (Hashtable から継承されます。)
	ContainsKey	Hashtable に特定のキーが格納されているかどうかを判断します。 (Hashtable から継承されます。)
	ContainsValue	Hashtable に特定の値が格納されているかどうかを判断します。 (Hashtable から継承されます。)
	CopyTo	1 次元の Array インスタンスの指定したインデックスに Hashtable の要素をコピーします。 (Hashtable から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	Hashtable を反復処理する IDictionaryEnumerator を返します。 (Hashtable から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	ISerializable インターフェイスを実装し、Hashtable をシリアル化するために必要なデータを返します。 (Hashtable から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	OnDeserialization	ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントを発生させます。 (Hashtable から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	指定したキーを持つ要素を Hashtable から削除します。 (Hashtable から継承されます。)
	Synchronized	Hashtable 用の同期された (スレッド セーフな) ラッパーを返します。 (Hashtable から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetHash	指定したキーのハッシュ コードを返します。 (Hashtable から継承されます。)
	KeyEquals	特定の Object を Hashtable 内の特定のキーと比較します。 (Hashtable から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SettingsContext クラス
System.Configuration 名前空間

その他の技術情報

ASP.NET アプリケーションの構成