次の方法で共有


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

例外

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

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

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

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

注釈

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

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

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

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

適用対象

こちらもご覧ください