WindowsFormsApplicationBase.SaveMySettingsOnExit プロパティ

定義

アプリケーションの終了時にユーザー設定を保存するかどうかを決定します。Determines whether the application saves the user settings on exit.

public:
 property bool SaveMySettingsOnExit { bool get(); void set(bool value); };
public bool SaveMySettingsOnExit { get; set; }
member this.SaveMySettingsOnExit : bool with get, set
Public Property SaveMySettingsOnExit As Boolean

プロパティ値

True は、アプリケーションが終了時にユーザー設定を保存することを示します。True to indicate that the application saves the user settings on exit. それ以外の場合は、False 設定が暗黙的に保存されないことを示します。Otherwise, False to indicate the settings are not implicitly saved.

この例は 2 つの部分で構成されています。This example has two parts.

  • InitializeSaveMySettingsOnExit サブルーチン。 CheckBox コントロールのチェックされた状態を、SaveMySettingsOnExit プロパティの現在の値に初期化します。The InitializeSaveMySettingsOnExit subroutine, which initializes the checked state of a CheckBox control to the current value of the SaveMySettingsOnExit property.

  • SaveMySettingsOnExit_CheckedChanged サブルーチン。 My.Application.SaveMySettingsOnExit プロパティを更新するために、CheckBox コントロールに対する変更を処理します。The SaveMySettingsOnExit_CheckedChanged subroutine, which handles changes to a CheckBox control to update the My.Application.SaveMySettingsOnExit property.

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

この例を使用するには、アプリケーションに SaveMySettingsOnExitという名前の CheckBox コントロールが必要です。For this example to work, your application must have a CheckBox control named SaveMySettingsOnExit.

注釈

SaveMySettingsOnExit プロパティを使用すると、アプリケーションが実行時に設定を保存する方法をユーザーが変更できます。The SaveMySettingsOnExit property allows the user to change how the application saves settings, at run time. My.Settings オブジェクトの Save メソッドを使用して、設定の変更を明示的に保存できます。You can explicitly save setting changes by using the Save method of the My.Settings object. 設定の変更と保存の詳細については、「アプリケーションのプロパティ」を参照してください。For more information about changing and saving settings, see Application Properties.

このプロパティへの変更は、アプリケーションの終了時には保持されません。The changes to this property are not persisted when the application closes. SaveMySettingsOnExit プロパティを完全に変更するには、プロジェクトデザイナーで設定を変更する必要があります。To change the SaveMySettingsOnExit property permanently, you must change the setting in the Project Designer:

プロジェクトデザイナーで設定を変更するにはTo change the setting in the Project Designer
1.ソリューション エクスプローラーでプロジェクトを選択します。1. Have a project selected in Solution Explorer. [プロジェクト] メニューの [プロパティ] をクリックします。Click Properties on the Project menu.
2.[アプリケーション] タブをクリックします。2. Click the Application tab.
3.[シャットダウン時に設定を保存] を選択します。3. Select Save My.Settings on Shutdown.

プロジェクトの種類別の可用性Availability by Project Type

プロジェクトの種類Project type 使用可能Available
Windows フォーム アプリケーションWindows Forms Application はいYes
クラス ライブラリClass Library いいえNo
コンソール アプリケーションConsole Application いいえNo
Windows フォーム コントロール ライブラリWindows Forms Control Library いいえNo
Web コントロールライブラリWeb Control Library いいえNo
Windows サービスWindows Service いいえNo
Web サイトWeb Site いいえNo

適用対象

こちらもご覧ください