SettingsBase.Item[String] プロパティ

定義

名前空間:
System.Configuration
アセンブリ:
System.dll

指定した設定プロパティの値を取得または設定します。

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };
public virtual object this[string propertyName] { get; set; }
member this.Item(string) : obj with get, set
Default Public Overridable Property Item(propertyName As String) As Object

パラメーター

propertyName
String

アクセスするプロパティの名前を含む String 。

プロパティ値

Object

見つかった場合は、名前付き設定プロパティの値。

例外

SettingsPropertyNotFoundException

現在のオブジェクトに関連付けられているプロパティがないか、指定したプロパティが見つかりませんでした。

SettingsPropertyIsReadOnlyException

読み取り専用プロパティを設定しようとしました。

SettingsPropertyWrongTypeException

指定された値は、設定操作中に settings プロパティと互換性のない型です。

注釈

Item[] プロパティ (インデクサーとも呼ばれます) は、SettingsBaseから派生した設定クラスで日常的に使用されます。 Item[] プロパティは、クラスのパブリック プロパティを対応する設定プロパティにバインドします。

プロパティに初めてアクセスすると、 SettingsBase インスタンスは、要求されたプロパティと同じプロバイダーを共有する他のすべてのプロパティを検索します。 その後、 SettingsBase インスタンスはプロバイダーを呼び出し、プロバイダーが取得する必要があるデータを表す一連の SettingsProperty オブジェクトを渡します。

IsSynchronizedがtrueされている場合、インデクサーはスレッド セーフな方法でプロパティ データを取得および設定します。 既定では、 SettingsBase インスタンスはスレッド セーフではありません。 ただし、 Synchronizedを呼び出し、 SettingsBase インスタンスを渡して、 SettingsBase インデクサーをスレッド セーフな方法で動作させることができます。

適用対象

こちらもご覧ください