ClientSettingsProvider.SettingsSaved Kejadian
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Terjadi setelah penyedia pengaturan mencoba menyimpan nilai properti ke layanan pengaturan 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)
Jenis Acara
Contoh
Contoh kode berikut menunjukkan cara menggunakan kejadian ini untuk menampilkan daftar pengaturan yang tidak berhasil disimpan.
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
Keterangan
Kejadian ini terjadi setelah penyedia pengaturan mengakses layanan pengaturan, meskipun pengaturan tidak berhasil disimpan. Salah satu alasan penyedia mungkin gagal menyimpan pengaturan adalah jika pengguna saat ini telah keluar. Anda dapat menggunakan SettingsSavedEventArgs.FailedSettingsList properti untuk menentukan apakah pengaturan apa pun tidak berhasil disimpan.
Kejadian ini tidak terjadi jika penyedia pengaturan tidak dapat mengakses layanan pengaturan, yang malah menyebabkan penyedia melempar WebException.