ClientSettingsProvider Класс

Определение

public ref class ClientSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider

public class ClientSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

[System.Security.SecurityCritical]
public class ClientSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

type ClientSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider

[<System.Security.SecurityCritical>]
type ClientSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider

Public Class ClientSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider

Наследование

Object

ProviderBase

SettingsProvider

ClientSettingsProvider

Атрибуты

SecurityCriticalAttribute

Реализации

IApplicationSettingsProvider

Примеры

В следующем примере кода показано, как использовать это событие для отображения списка параметров, которые не были успешно сохранены.

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

Комментарии

Службы клиентских приложений можно использовать для получения параметров пользователя из существующей службы веб-параметров, настроив приложение для использования ClientSettingsProvider класса . После настройки можно получить и задать пользовательские параметры с помощью класса параметров приложения, производного от ApplicationSettingsBase и настроенного ClientSettingsProvider для использования класса . Вы можете использовать Visual Studio для создания Settings класса для проекта (доступ к как Properties.Settings.Default в C# и My.Settings в Visual Basic). Дополнительные сведения о параметрах приложения см. в разделе Общие сведения о параметрах приложения.

Текущий ClientSettingsProvider объект можно получить с помощью ApplicationSettingsBase.Providers свойства , используя полное ClientSettingsProvider имя класса в качестве ключа. Поставщик также можно получить с помощью SettingsLoadedEventArgs.Provider свойства при обработке ApplicationSettingsBase.SettingsLoaded события.

Конструкторы

Свойства

Методы

События

Применяется к

См. также раздел

• Providers
• SettingsLoaded
• Службы клиентских приложений
• Общие сведения о параметрах приложений
• Практическое руководство. Создание параметров приложения