ClientSettingsProvider.SettingsSaved Evento

Riferimento

Definizione

Spazio dei nomi:: System.Web.ClientServices.Providers

Assembly:: System.Web.Extensions.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 Custom Event SettingsSaved As EventHandler(Of 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 non 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 usare 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 può accedere al servizio impostazioni, che causa invece che il provider generi un WebExceptionoggetto .

Si applica a

Condividi tramite