ApplicationSettingsBase.Reset メソッド

定義

名前空間:
System.Configuration
アセンブリ:
System.dll

永続化されたアプリケーション設定の値を、対応する既定のプロパティに復元します。

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

例外

ConfigurationErrorsException

構成ファイルを解析できませんでした。

例

次のコード例は、Reset という名前のボタンのClick イベント ハンドラーの本体で呼び出されるbtnReset メソッドを示しています。 この呼び出しの結果、アプリケーション設定の格納されている既定値が対応するプロパティに再読み込みされます。 完全なコード例は、 ApplicationSettingsBase クラスの概要に記載されています。

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()
    BackColor = SystemColors.Control
End Sub

注釈

Reset メソッドは、各アプリケーション設定の現在永続化されている値を復元することによって、ユーザー スコープの設定プロパティを上書きします。 このメソッドは、次のアクションを実行します。

  • この省略可能なメソッドをサポートするすべての設定プロバイダーで、 IApplicationSettingsProvider.Reset メソッドを呼び出します。

  • Reload メソッドを呼び出して、設定プロパティ値を強制的に更新します。

Reload は、前者が保存されたアプリケーション設定値の最後のセットを読み込むという点で Reset と対照的ですが、後者は保存された既定値を読み込みます。

適用対象

こちらもご覧ください