ClientSettingsProvider.SettingsSaved Evento

Definizione

Spazio dei nomi:

System.Web.ClientServices.Providers

Assembly:

System.Web.Extensions.dll

Si verifica dopo il tentativo del provider di impostazioni di salvare i valori della proprietà nel servizio delle impostazioni 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 Event SettingsSaved As EventHandler(Of SettingsSavedEventArgs) 

Tipo evento

EventHandler<SettingsSavedEventArgs>

Esempio

Il codice di esempio seguente illustra come usare questo evento per visualizzare un elenco di impostazioni che non sono state salvate correttamente.

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

Commenti

Questo evento si verifica dopo che il provider di impostazioni accede al servizio impostazioni, anche se le impostazioni non sono state salvate correttamente. Un motivo per cui il provider potrebbe non riuscire a salvare le impostazioni è se l'utente corrente è stato disconnesso. È possibile utilizzare la SettingsSavedEventArgs.FailedSettingsList proprietà per determinare se le impostazioni non sono state salvate correttamente.

Questo evento non si verifica se il provider di impostazioni non riesce ad accedere al servizio delle impostazioni, che invece fa sì che il provider generi un'eccezione WebException.

Vedi anche

• FailedSettingsList
• SettingsLoaded
• Logout()
• Logout()
• Servizi applicazioni client