ClientSettingsProvider Classe

Definição

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

Herança

Object

ProviderBase

SettingsProvider

ClientSettingsProvider

Atributos

SecurityCriticalAttribute

Implementações

IApplicationSettingsProvider

Exemplos

O código de exemplo seguinte demonstra como usar este evento para mostrar uma lista de definições que não foram guardadas com sucesso.

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

Observações

Pode usar serviços de aplicação cliente para recuperar definições de utilizador de um serviço de definições Web existente, configurando a sua aplicação para usar a ClientSettingsProvider classe. Após a configuração, pode obter e definir definições de utilizador através de uma classe de definições de aplicação derivada e ApplicationSettingsBase configurada para usar a ClientSettingsProvider classe. Podes usar Visual Studio para gerar uma classe Settings para o teu projeto (acedida como Properties.Settings.Default em C# e My.Settings em Visual Basic). Para mais informações sobre as definições da aplicação, consulte Visão Geral das Definições da Aplicação.

Pode recuperar a corrente ClientSettingsProvider através da ApplicationSettingsBase.Providers propriedade usando o nome da classe totalmente qualificada ClientSettingsProvider como chave. Também pode recuperar o prestador através da SettingsLoadedEventArgs.Provider propriedade quando tratar do ApplicationSettingsBase.SettingsLoaded evento.

Ver também

• Providers
• SettingsLoaded
• Serviços de Aplicações para Clientes
• Visão geral das configurações do aplicativo
• Como: Criar configurações do aplicativo