ApplicationSettingsBase.Item[String] プロパティ

定義

指定したアプリケーション設定プロパティの値を取得または設定します。

C#
public override object this[string propertyName] { get; set; }

パラメーター

propertyName
String

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

プロパティ値

指定した設定プロパティが見つかった場合は、そのプロパティの値。それ以外の場合は null

例外

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

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

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

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

注釈

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

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

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

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

適用対象

製品 バージョン
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

こちらもご覧ください