SettingsSavedEventArgs.FailedSettingsList Proprietà

Definizione

Spazio dei nomi:

System.Web.ClientServices.Providers

Assembly:

System.Web.Extensions.dll

Ottiene le impostazioni che ClientSettingsProvider non è in grado di salvare nel 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)

Valore della proprietà

ReadOnlyCollection<String>

Le impostazioni che non sono state salvate.

Esempio

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

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.

Vedi anche

• FailedSettingsList
• ClientSettingsProvider
• SettingsSaved
• SettingsLoaded
• Logout()
• Logout()
• Servizi applicazioni client