SettingsSavedEventArgs Classe
Definizione
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.
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à
Esempio
Il codice di esempio seguente illustra come usare questa classe 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
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 usare la 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 .
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) |