SettingsSavedEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.ClientServices.Providers
Assembly:
System.Web.Extensions.dll

Fornisce i dati per l'evento SettingsSaved.

public ref class SettingsSavedEventArgs : EventArgs
public class SettingsSavedEventArgs : EventArgs
type SettingsSavedEventArgs = class
    inherit EventArgs
Public Class SettingsSavedEventArgs
Inherits EventArgs
Ereditarietà
Object
EventArgs
SettingsSavedEventArgs

Esempio

Il codice di esempio seguente illustra come usare questa classe 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

L'evento ClientSettingsProvider.SettingsSaved 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 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.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Costruttori

SettingsSavedEventArgs(IEnumerable<String>)

Inizializza una nuova istanza della classe SettingsSavedEventArgs.

Proprietà

FailedSettingsList

Ottiene le impostazioni che ClientSettingsProvider non è in grado di salvare nel server.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche