ClientSettingsProvider Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.ClientServices.Providers

Assembly:: System.Web.Extensions.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Consente alle applicazioni basate su Windows di recuperare le impostazioni utente da un servizio delle impostazioni Web.

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

Ereditarietà: Object

ProviderBase

SettingsProvider
ClientSettingsProvider

Attributi: SecurityCriticalAttribute

Implementazioni: IApplicationSettingsProvider

Esempio

Il codice di esempio seguente illustra come usare questo evento 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

È possibile usare i servizi applicazione client per recuperare le impostazioni utente da un servizio impostazioni Web esistente configurando l'applicazione per usare la ClientSettingsProvider classe . Dopo la configurazione, è possibile ottenere e impostare le impostazioni utente tramite una classe di impostazioni dell'applicazione derivata da ApplicationSettingsBase e configurata per l'uso della ClientSettingsProvider classe. È possibile usare Visual Studio per generare una Settings classe per il progetto (accessibile come Properties.Settings.Default in C# e My.Settings in Visual Basic). Per altre informazioni sulle impostazioni dell'applicazione, vedere Cenni preliminari sulle impostazioni delle applicazioni.

È possibile recuperare l'oggetto corrente ClientSettingsProvider tramite la ApplicationSettingsBase.Providers proprietà usando il ClientSettingsProvider nome completo della classe come chiave. È anche possibile recuperare il provider tramite la SettingsLoadedEventArgs.Provider proprietà quando si gestisce l'evento ApplicationSettingsBase.SettingsLoaded .

Nota

Questa classe contiene un SecurityCriticalAttribute oggetto a livello di classe che si applica a tutti i membri della classe. Viene generata un'eccezione di runtime se il chiamante immediato è trasparente o parzialmente attendibile. Per altre informazioni sui tipi e i membri critici per la sicurezza, vedere Security-Transparent Code, Livello 2.

Nota

Questa classe contiene una richiesta di ereditarietà a livello di classe che si applica a tutti i membri. Viene SecurityException generato quando la classe derivata non dispone dell'autorizzazione di attendibilità completa. Per informazioni dettagliate sulle richieste di sicurezza, vedere Collegare richieste e richieste di ereditarietà.

Costruttori

ClientSettingsProvider()

Inizializza una nuova istanza della classe ClientSettingsProvider.

Proprietà

ApplicationName	Questa proprietà non viene usata da questa classe.
Description	Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface). (Ereditato da ProviderBase)
Name	Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione. (Ereditato da ProviderBase)
ServiceUri	Ottiene o imposta il percorso del servizio delle impostazioni Web.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetPreviousVersion(SettingsContext, SettingsProperty)	Ottiene la versione precedente della proprietà specificata.
GetPropertyMetadata(String)	Ottiene un insieme di metadati per tutte le proprietà recuperate dal servizio delle impostazioni Web specificato.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Restituisce l'insieme di valori delle proprietà delle impostazioni per l'istanza dell'applicazione specificata e per il gruppo di proprietà delle impostazioni.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Initialize(String, NameValueCollection)	Inizializza il provider.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Reset(SettingsContext)	Reimposta tutte le impostazioni utente sui valori predefiniti.
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Imposta i valori del gruppo specificato di impostazioni delle proprietà.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	Questo metodo non viene utilizzato da questa classe.

Eventi

SettingsSaved

Si verifica dopo il tentativo del provider di impostazioni di salvare i valori della proprietà nel servizio delle impostazioni Web.

Si applica a