ApplicationSettingsBase.SettingChanging イベント

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

ApplicationSettingsBase.SettingChanging イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーション設定プロパティの値が変更される前に発生します。

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

Visual Basic (宣言)

Public Event SettingChanging As
 SettingChangingEventHandler

Visual Basic (使用法)

Dim instance As ApplicationSettingsBase
Dim handler As SettingChangingEventHandler

AddHandler instance.SettingChanging, handler

C#

public event SettingChangingEventHandler SettingChanging

C++

public:
event SettingChangingEventHandler^ SettingChanging {
    void add (SettingChangingEventHandler^ value);
    void remove (SettingChangingEventHandler^ value);
}

J#

/** @event */
public void add_SettingChanging (SettingChangingEventHandler
 value)

/** @event */
public void remove_SettingChanging (SettingChangingEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

SettingChanging イベントは、Item メソッドによってアプリケーション設定値のプロパティが変更される前に発生します。Reload メソッドまたは Reset メソッドが呼び出されたときには、このイベントは発生しません。SettingChanging は、SettingChangingEventArgs イベント データ クラスを使用してキャンセルできます。

SettingChanging イベントは、通常、各設定プロパティの即時検証を処理するために使用します。検証の詳細については、「方法 : アプリケーション設定を検証する」を参照してください。

このクラスの対応する SettingChanged イベントはありません。代わりに、PropertyChanged イベントに関するトピックを参照してください。

使用例

ApplicationSettingsBase から派生したラッパー クラスである、FormSettings 型のオブジェクトの SettingChanging イベント ハンドラを次のコード例に示します。このハンドラは、tbStatus という名前のテキストボックスにイベント情報を表示します。完全なコード例は、ApplicationSettingsBase クラスの概要に記載されています。

C#

void frmSettings1_SettingChanging(object sender, SettingChangingEventArgs
 e)
{
    tbStatus.Text = e.SettingName + ": " + e.NewValue;
}

C++

private:
    void FormSettings_SettingChanging(Object^ sender,
        SettingChangingEventArgs^ e)
    {
        statusDisplay->Text = e->SettingName + ": " + e->NewValue;
    }

プラットフォーム

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 名前空間
OnSettingChanging
SettingChangingEventArgs
ApplicationSettingsBase.PropertyChanged イベント
ApplicationSettingsBase.Item プロパティ
その他の技術情報
方法 : アプリケーション設定を検証する