ApplicationSettingsBase.SettingChanging Evento

Definición

Se produce antes de cambiar el valor de una propiedad de configuración de la aplicación.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 

Tipo de evento

SettingChangingEventHandler

Ejemplos

En el ejemplo de código siguiente SettingChanging se muestra el controlador de eventos para el objeto de tipo FormSettings , que es una clase contenedora derivada de ApplicationSettingsBase .The following code example shows the SettingChanging event handler for object of type FormSettings, which is a wrapper class derived from ApplicationSettingsBase. El controlador muestra la información de evento en un cuadro de texto denominado tbStatus .The handler displays the event information in a textbox named tbStatus. El ejemplo de código completo se muestra en la ApplicationSettingsBase información general de la clase.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

Comentarios

El SettingChanging evento tiene lugar antes de que se cambie una propiedad de valor de configuración de la aplicación mediante el Item[] método.The SettingChanging event occurs before an application setting value property is changed through the Item[] method. Este evento no se genera cuando Reload Reset se llama a los métodos o.This event is not raised when the Reload or Reset methods are called. SettingChanging se puede cancelar a través de la SettingChangingEventArgs clase de datos de evento.SettingChanging can be canceled through the SettingChangingEventArgs event data class.

Normalmente, el evento se utiliza SettingChanging para controlar la validación inmediata de una propiedad de configuración individual.You typically use the SettingChanging event to handle immediate validation of an individual settings property. Para obtener más información sobre la validación, vea Cómo: validar la configuración de la aplicación.For more information about validation, see How to: Validate Application Settings.

No hay ningún SettingChanged evento correspondiente para esta clase; en su lugar, vea el PropertyChanged evento.There is no corresponding SettingChanged event for this class; instead, see the PropertyChanged event.

Se aplica a

Consulte también