ApplicationSettingsBase.SettingChanging ApplicationSettingsBase.SettingChanging ApplicationSettingsBase.SettingChanging ApplicationSettingsBase.SettingChanging Event

定義

アプリケーション設定プロパティの値が変更される前に発生します。Occurs before the value of an application settings property is changed.

public:
 event System::Configuration::SettingChangingEventHandler ^ SettingChanging;
public event System.Configuration.SettingChangingEventHandler SettingChanging;
member this.SettingChanging : System.Configuration.SettingChangingEventHandler 
Public Custom Event SettingChanging As SettingChangingEventHandler 

次のコード例は、 SettingChangingからApplicationSettingsBase派生したラッパークラスFormSettingsである型のオブジェクトのイベントハンドラーを示しています。The following code example shows the SettingChanging event handler for object of type FormSettings, which is a wrapper class derived from ApplicationSettingsBase. ハンドラーは、という名前tbStatusのテキストボックスにイベント情報を表示します。The handler displays the event information in a textbox named tbStatus. 完全なコード例についてはApplicationSettingsBase 、クラスの概要に記載されています。The full code example is listed in the ApplicationSettingsBase class overview.

private:
    void FormSettings_SettingChanging(Object^ sender,
        SettingChangingEventArgs^ e)
    {
        statusDisplay->Text = e->SettingName + ": " + e->NewValue;
    }
void frmSettings1_SettingChanging(object sender, SettingChangingEventArgs e)
{
    tbStatus.Text = e.SettingName + ": " + e.NewValue;
}
Private Sub frmSettings1_SettingChanging(ByVal sender As Object, ByVal e As _
        SettingChangingEventArgs) Handles frmSettings1.SettingChanging
    tbStatus.Text = e.SettingName & ": " & e.NewValue.ToString
End Sub

注釈

イベントSettingChangingは、 Item[String]メソッドによってアプリケーション設定値プロパティが変更される前に発生します。The SettingChanging event occurs before an application setting value property is changed through the Item[String] method. このイベントは、 ReloadメソッドまたはResetメソッドが呼び出されたときには発生しません。This event is not raised when the Reload or Reset methods are called. SettingChangingは、イベントデータクラスSettingChangingEventArgsを使用して取り消すことができます。SettingChanging can be canceled through the SettingChangingEventArgs event data class.

通常、イベントをSettingChanging使用して、個々の設定プロパティの即時検証を処理します。You typically use the SettingChanging event to handle immediate validation of an individual settings property. 検証の詳細については、「」を参照してください。アプリケーション設定を検証します。For more information about validation, see How to: Validate Application Settings.

このクラスに対応SettingChangedするイベントはありません。代わりに、 PropertyChangedイベントを参照してください。There is no corresponding SettingChanged event for this class; instead, see the PropertyChanged event.

適用対象

こちらもご覧ください