ClientSettingsProvider.SettingsSaved Evento

Referencia

Definición

Espacio de nombres:: System.Web.ClientServices.Providers

Ensamblado:: System.Web.Extensions.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Se produce después de que el proveedor de configuración intenta guardar los valores de la propiedad en el servicio de configuración web.

public:
 event EventHandler<System::Web::ClientServices::Providers::SettingsSavedEventArgs ^> ^ SettingsSaved;

public event EventHandler<System.Web.ClientServices.Providers.SettingsSavedEventArgs> SettingsSaved;

member this.SettingsSaved : EventHandler<System.Web.ClientServices.Providers.SettingsSavedEventArgs>

Public Custom Event SettingsSaved As EventHandler(Of SettingsSavedEventArgs)

Public Event SettingsSaved As EventHandler(Of SettingsSavedEventArgs)

Tipo de evento

EventHandler<SettingsSavedEventArgs>

Ejemplos

En el código de ejemplo siguiente se muestra cómo usar este evento para mostrar una lista de opciones de configuración que no se guardaron correctamente.

private void AttachSettingsSavedEventHandler()
{
    ((ClientSettingsProvider)Properties.Settings.Default.Providers
        ["System.Web.ClientServices.Providers.ClientSettingsProvider"])
        .SettingsSaved +=
        new EventHandler<SettingsSavedEventArgs>(Form1_SettingsSaved);
}

private void Form1_SettingsSaved(object sender,
    SettingsSavedEventArgs e)
{
    // If any settings were not saved, display a list of them.
    if (e.FailedSettingsList.Count > 0)
    {
        String failedSettings = String.Join(
            Environment.NewLine,
            e.FailedSettingsList.ToArray());

        String message = String.Format("{0}{1}{1}{2}",
            "The following setting(s) were not saved:",
            Environment.NewLine, failedSettings);

        MessageBox.Show(message, "Unable to save settings",
            MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
}

Private WithEvents settingsProvider As ClientSettingsProvider = My.Settings _
    .Providers("System.Web.ClientServices.Providers.ClientSettingsProvider")

Private Sub Form1_SettingsSaved(ByVal sender As Object, _
    ByVal e As SettingsSavedEventArgs) _
    Handles settingsProvider.SettingsSaved

    ' If any settings were not saved, display a list of them.
    If e.FailedSettingsList.Count > 0 Then

        Dim failedSettings As String = String.Join( _
            Environment.NewLine, e.FailedSettingsList.ToArray())

        Dim message As String = String.Format("{0}{1}{1}{2}", _
            "The following setting(s) were not saved:", _
            Environment.NewLine, failedSettings)

        MessageBox.Show(message, "Unable to save settings", _
            MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End If

End Sub

Comentarios

Este evento se produce después de que el proveedor de configuración acceda al servicio de configuración, incluso si la configuración no se guardó correctamente. Una razón por la que el proveedor podría no guardar la configuración es si el usuario actual ha cerrado la sesión. Puede usar la SettingsSavedEventArgs.FailedSettingsList propiedad para determinar si alguna configuración no se guardó correctamente.

Este evento no se produce si el proveedor de configuración no puede tener acceso al servicio de configuración, lo que hace que el proveedor inicie una WebExceptionexcepción .

Se aplica a

Compartir vía