SettingsBase.Item[String] プロパティ

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v8.0.0

ソース:

SettingsBase.cs

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

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

指定された値は、設定操作時の設定プロパティと型の互換性がありません。

注釈

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

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

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

こちらもご覧ください

• IsReadOnly