SettingsSavedEventArgs.FailedSettingsList Properti

Referensi

Definisi

Ruang nama:: System.Web.ClientServices.Providers

Rakitan:: System.Web.Extensions.dll

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.

Mendapatkan pengaturan yang ClientSettingsProvider tidak dapat disimpan ke server.

public:
 property System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FailedSettingsList { System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ get(); };

public System.Collections.ObjectModel.ReadOnlyCollection<string> FailedSettingsList { get; }

member this.FailedSettingsList : System.Collections.ObjectModel.ReadOnlyCollection<string>

Public ReadOnly Property FailedSettingsList As ReadOnlyCollection(Of String)

Nilai Properti

ReadOnlyCollection<String>

Pengaturan yang tidak disimpan.

Contoh

Contoh kode berikut menunjukkan cara menggunakan properti 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

Salah satu alasan penyedia mungkin gagal menyimpan pengaturan adalah jika pengguna saat ini telah keluar. Anda dapat menggunakan FailedSettingsList properti untuk menentukan apakah pengaturan apa pun tidak berhasil disimpan.

Berlaku untuk

Bagikan melalui