WindowsFormsApplicationBase.SaveMySettingsOnExit プロパティ

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

WindowsFormsApplicationBase.SaveMySettingsOnExit プロパティ

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

アプリケーションの終了時にユーザー設定を保存するかどうかを決定します。

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Property SaveMySettingsOnExit As
 Boolean

Visual Basic (使用法)

Dim instance As WindowsFormsApplicationBase
Dim value As Boolean

value = instance.SaveMySettingsOnExit

instance.SaveMySettingsOnExit = value

C#

public bool SaveMySettingsOnExit { get;
 set; }

C++

public:
property bool SaveMySettingsOnExit {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_SaveMySettingsOnExit ()

/** @property */
public void set_SaveMySettingsOnExit (boolean
 value)

JScript

public function get SaveMySettingsOnExit
 () : boolean

public function set SaveMySettingsOnExit
 (value : boolean)

プロパティ値
Boolean。True の場合、アプリケーションの終了時にユーザー設定が保存されます。それ以外の場合、設定は暗黙的に保存されません。

解説

詳細については、Visual Basic のトピック「My.Application.SaveMySettingsOnExit プロパティ」を参照してください。

SaveMySettingsOnExit プロパティを使用すると、アプリケーション実行時における設定の保存方法を変更できます。My.Settings オブジェクトの Save メソッドを使用すると、設定に対する変更を明示的に保存できます。設定の変更と保存の詳細については、「My.Settings オブジェクト」を参照してください。

このプロパティに対する変更は、アプリケーションの終了時に失われます。SaveMySettingsOnExit プロパティを永続的に変更するには、プロジェクト デザイナで設定を変更する必要があります。

プロジェクト デザイナで設定を変更するには

ソリューション エクスプローラでプロジェクトを選択します。[プロジェクト] メニューの [プロパティ] をクリックします。

[アプリケーション] タブをクリックします。

[シャットダウン時に My.Settings を保存する] を選択します。

詳細については、「アプリケーション プロパティの管理」を参照してください。

使用例

この例は、2 つの部分で構成されます。

• InitializeSaveMySettingsOnExit サブルーチンでは、CheckBox コントロールのチェック状態を、SaveMySettingsOnExit プロパティの現在の値に初期化しています。

• SaveMySettingsOnExit_CheckedChanged サブルーチンでは、CheckBox コントロールに対する変更イベントを処理して、My.Application.SaveMySettingsOnExit プロパティを更新しています。

Visual Basic

Private Sub InitializeSaveMySettingsOnExit()
    SaveMySettingsOnExit.Checked = _
        My.Application.SaveMySettingsOnExit
End Sub
Private Sub SaveMySettingsOnExit_CheckedChanged(
 _
    ByVal sender As System.Object, _
    ByVal e As System.EventArgs _
) Handles SaveMySettingsOnExit.CheckedChanged
    My.Application.SaveMySettingsOnExit = _
        SaveMySettingsOnExit.Checked
End Sub

この例は、アプリケーションに SaveMySettingsOnExit という名前の CheckBox コントロールが配置されていることを前提としています。

プラットフォーム

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

参照

関連項目
WindowsFormsApplicationBase クラス
WindowsFormsApplicationBase メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
WindowsFormsApplicationBase.SaveMySettingsOnExit プロパティ
Save
その他の技術情報
My.Application.SaveMySettingsOnExit プロパティ
My.Application オブジェクト
My.Settings オブジェクト