Language

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 イベントが発生します。

適用対象

こちらもご覧ください