SettingsBase.Item[String] プロパティ

定義

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

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

プロパティ値

存在する場合は、名前付き設定プロパティの値。

例外

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

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

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

注釈

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

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

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

適用対象

こちらもご覧ください