ApplicationSettingsBase.Item プロパティ

.NET Framework クラス ライブラリ リファレンス

ApplicationSettingsBase.Item プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Configuration
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overrides Default
 Property Item ( _
    propertyName As String _
) As Object

Visual Basic (使用法)

Dim instance As ApplicationSettingsBase
Dim propertyName As String
Dim value As Object

value = instance(propertyName)

instance(propertyName) = value

C#

public override Object this [
    string propertyName
] { get; set; }

C++

public:
virtual property Object^ default [String^] {
    Object^ get (String^ propertyName) override;
    void set (String^ propertyName, Object^
 value) override;
}

J#

/** @property */
public Object get_Item (String propertyName)

/** @property */
public void set_Item (String propertyName,
 Object value)

JScript

JScript では、インデックス付きのプロパティは使用できますが、新規に宣言することはできません。.

パラメータ

propertyName

アクセスするプロパティの名前を格納している String。

プロパティ値
指定した設定プロパティが見つかった場合は、そのプロパティの値。それ以外の場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
SettingsPropertyNotFoundException	現在のラッパーに関連付けられたプロパティが存在しないか、指定したプロパティが見つかりませんでした。
SettingsPropertyIsReadOnlyException	読み取り専用プロパティを設定しようとしました。
SettingsPropertyWrongTypeException	指定された値は、設定操作時の設定プロパティと型の互換性がありません。

解説

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

Item は、実行している操作に応じて、次のイベントを発生させます。

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

• プロパティの設定時には、OnSettingChanging イベントが発生します。ハンドラがこのイベントをキャンセルしない場合は、プロパティ値が設定され、PropertyChanged イベントが発生します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ApplicationSettingsBase クラス
ApplicationSettingsBase メンバ
System.Configuration 名前空間
Properties
IsReadOnly