ApplicationSettingsBase.SettingsSaving イベント

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

ApplicationSettingsBase.SettingsSaving イベント

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

データ ストアに値が保存される前に発生します。

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

Visual Basic (宣言)

Public Event SettingsSaving As
 SettingsSavingEventHandler

Visual Basic (使用法)

Dim instance As ApplicationSettingsBase
Dim handler As SettingsSavingEventHandler

AddHandler instance.SettingsSaving, handler

C#

public event SettingsSavingEventHandler SettingsSaving

C++

public:
event SettingsSavingEventHandler^ SettingsSaving {
    void add (SettingsSavingEventHandler^ value);
    void remove (SettingsSavingEventHandler^ value);
}

J#

/** @event */
public void add_SettingsSaving (SettingsSavingEventHandler
 value)

/** @event */
public void remove_SettingsSaving (SettingsSavingEventHandler
 value)

JScript

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

解説

SettingsSaving イベントは、Save メソッドがアプリケーション設定プロパティを関連付けられたデータ ストアに格納する前に発生させます。関連付けられているイベント ハンドラは、このイベントをキャンセルできます。

使用例

ApplicationSettingsBase から派生したラッパー クラスである、FormSettings 型のオブジェクトの SettingsSaving イベント ハンドラを次のコード例に示します。このハンドラは、現在のアプリケーション設定プロパティ値を保存することをユーザーに確認します。完全なコード例は、ApplicationSettingsBase クラスの概要に記載されています。

C#

void frmSettings1_SettingsSaving(object sender, CancelEventArgs
 e)
{
    //Should check for settings changes first.
    DialogResult dr = MessageBox.Show(
                    "Save current values for application
 settings?",
                    "Save Settings", MessageBoxButtons.YesNo);
    if (DialogResult.No == dr)
    {
        e.Cancel = true;
    }
}

C++

private:
    void FormSettings_SettingsSaving(Object^ sender,
        CancelEventArgs^ e)
    {
        //Should check for settings changes first.
        ::DialogResult^ dialogResult = MessageBox::Show(
            "Save current values for application settings?"
,
            "Save Settings", MessageBoxButtons::YesNo);
        if (::DialogResult::No == dialogResult)
        {
            e->Cancel = true;
        }
    }

プラットフォーム

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 名前空間
OnSettingsSaving
Save