ApplicationSettingsBase.Item[String] プロパティ

  • リファレンス

定義

名前空間:
System.Configuration
アセンブリ:
System.Configuration.ConfigurationManager.dll
アセンブリ:
System.dll
パッケージ:
System.Configuration.ConfigurationManager v6.0.0
パッケージ:
System.Configuration.ConfigurationManager v7.0.0
パッケージ:
System.Configuration.ConfigurationManager v8.0.0
パッケージ:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
ソース:
ApplicationSettingsBase.cs
ソース:
ApplicationSettingsBase.cs
ソース:
ApplicationSettingsBase.cs

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

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。

プロパティ値

Object

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

例外

SettingsPropertyNotFoundException

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

SettingsPropertyIsReadOnlyException

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

SettingsPropertyWrongTypeException

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

ConfigurationErrorsException

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

注釈

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

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

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

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

適用対象

こちらもご覧ください