SettingsSavedEventArgs.FailedSettingsList Proprietà

Definizione

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à

Le impostazioni che non sono state salvate.

Esempio

Nel codice di esempio seguente viene illustrato come utilizzare questa proprietà 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

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.

Si applica a

Vedi anche