ApplicationSettingsBase.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 override object this[string propertyName] { get; set; }
member this.Item(string) : obj with get, set
Default Public Overrides Property Item(propertyName As String) As Object

パラメーター

propertyName
String

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

プロパティ値

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

例外

現在のラッパーに関連付けられているプロパティがないか、指定したプロパティが見つかりませんでした。

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

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

構成ファイルを解析できませんでした。

注釈

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

Item[] は、実行される操作に応じていくつかのイベントを発生させます。

  • プロパティを初めて取得すると、 SettingsLoaded イベントが発生します。

  • プロパティを設定すると、 OnSettingChanging イベントが発生します。 ハンドラーがイベントを取り消さない場合は、プロパティ値が設定され、 PropertyChanged イベントが発生します。

適用対象

こちらもご覧ください