ApplicationSettingsBase.Reset メソッド

定義

保持されているアプリケーション設定値を対応する既定のプロパティに復元します。Restores the persisted application settings values to their corresponding default properties.

public:
 void Reset();
public void Reset ();
member this.Reset : unit -> unit
Public Sub Reset ()

例外

構成ファイルを解析できませんでした。The configuration file could not be parsed.

次のコード例は、 Resetという名前btnResetのボタンのClickイベントハンドラーの本体で呼び出されるメソッドを示しています。The following code example shows the Reset method being invoked in the body of the Click event handler for a button named btnReset. この呼び出しの結果として、アプリケーション設定に格納されている既定値が、対応するプロパティに再読み込みされます。As a result of this call, the stored default values for the application settings are reloaded into their corresponding properties. 完全なコード例についてはApplicationSettingsBase 、クラスの概要に記載されています。The full code example is listed in the ApplicationSettingsBase class overview.

private:
    void ResetButton_Click(Object^ sender, EventArgs^ e)
    {
        formSettings->Reset();
        this->BackColor = SystemColors::Control;
    }
private void btnReset_Click(object sender, EventArgs e)
{
    frmSettings1.Reset();
    this.BackColor = SystemColors.Control;
}
Private Sub btnReset_Click(ByVal sender As Object, ByVal e As EventArgs) _
        Handles btnReset.Click
    frmSettings1.Reset()
    Me.BackColor = SystemColors.Control
End Sub

注釈

メソッドResetは、各アプリケーション設定の現在の永続化値を復元することによって、ユーザースコープの設定プロパティを上書きします。The Reset method overwrites the user-scoped settings properties by restoring the currently persisted value of each application settings. このメソッドは、次のアクションを実行します。This method performs the following actions:

  • このメソッドはIApplicationSettingsProvider.Reset 、この省略可能なメソッドをサポートするすべての設定プロバイダーでメソッドを呼び出します。It calls the IApplicationSettingsProvider.Reset method on every settings provider that supports this optional method.

  • 設定プロパティのReload値を強制的に更新するには、メソッドを呼び出します。It calls the Reload method to force a refresh of the settings property values.

ReloadResetでは、前者が保存されたアプリケーション設定値の最後のセットを読み込むのに対し、後者は保存された既定値を読み込みます。Reload contrasts with Reset in that the former will load the last set of saved application settings values, whereas the latter will load the saved default values.

適用対象

こちらもご覧ください