ClientSettingsProvider ClientSettingsProvider ClientSettingsProvider ClientSettingsProvider Class

Definizione

Consente alle applicazioni basate su Windows di recuperare le impostazioni utente da un servizio delle impostazioni Web.Enables Windows-based applications to retrieve user settings from a Web settings service.

public ref 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
Public Class ClientSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider
Ereditarietà
Attributi
Implementazioni

Esempi

Esempio di codice seguente viene illustrato come utilizzare questo evento per visualizzare un elenco di impostazioni che non sono state salvate.The following example code demonstrates how to use this event to display a list of settings that were not successfully saved.

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 delle applicazioni client per recuperare le impostazioni da un servizio di impostazioni Web esistente mediante la configurazione dell'applicazione per usare il ClientSettingsProvider classe.You can use client application services to retrieve user settings from an existing Web settings service by configuring your application to use the ClientSettingsProvider class. Per altre informazioni, vedere Procedura: Configurare i servizi delle applicazioni client.For more information, see How to: Configure Client Application Services. Dopo la configurazione, è possibile ottenere e impostare le impostazioni utente tramite una classe di impostazioni dell'applicazione derivata da ApplicationSettingsBase e configurati per utilizzare il ClientSettingsProvider classe.After configuration, you can get and set user settings through an application settings class derived from ApplicationSettingsBase and configured to use the ClientSettingsProvider class. È 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).You can use Visual Studio to generate a Settings class for your project (accessed as Properties.Settings.Default in C# and My.Settings in Visual Basic). Per altre informazioni sulle impostazioni dell'applicazione, vedere Cenni preliminari sulle impostazioni delle applicazioni.For more information about application settings, see Application Settings Overview.

È possibile recuperare l'oggetto corrente ClientSettingsProvider tramite il ApplicationSettingsBase.Providers usando il nome completo di proprietà ClientSettingsProvider nome della classe come chiave.You can retrieve the current ClientSettingsProvider through the ApplicationSettingsBase.Providers property using the fully-qualified ClientSettingsProvider class name as a key. È anche possibile recuperare il provider tramite il SettingsLoadedEventArgs.Provider proprietà quando si gestisce il ApplicationSettingsBase.SettingsLoaded evento.You can also retrieve the provider through the SettingsLoadedEventArgs.Provider property when you handle the ApplicationSettingsBase.SettingsLoaded event.

Nota

Questa classe contiene un SecurityCriticalAttribute a livello di classe che si applica a tutti i membri della classe.This class contains a SecurityCriticalAttribute at the class level that applies to all members of the class. Se il chiamante immediato è trasparente per la sicurezza o parzialmente attendibile, viene generata un'eccezione in fase di esecuzione.A run-time exception is thrown if the immediate caller is security-transparent or partially trusted. Per altre informazioni sui tipi critici per la sicurezza e i membri, vedere codice SecurityTransparent, livello 2.For more information about security-critical types and members, see Security-Transparent Code, Level 2.

Nota

Questa classe contiene una richiesta di ereditarietà a livello di classe che si applica a tutti i membri.This class contains an inheritance demand at the class level that applies to all members. Oggetto SecurityException viene generata quando la classe derivata non dispone dell'autorizzazione di attendibilità.A SecurityException is thrown when the derived class does not have full-trust permission. Per informazioni dettagliate sui requisiti di sicurezza, vedere linking e richieste di ereditarietà.For details about security demands, see Link Demands and Inheritance Demands.

Costruttori

ClientSettingsProvider() ClientSettingsProvider() ClientSettingsProvider() ClientSettingsProvider()

Inizializza una nuova istanza della classe ClientSettingsProvider.Initializes a new instance of the ClientSettingsProvider class.

Proprietà

ApplicationName ApplicationName ApplicationName ApplicationName

Questa proprietà non viene usata da questa classe.This property is not used by this class.

Description Description Description Description

Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
Name Name Name Name

Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)
ServiceUri ServiceUri ServiceUri ServiceUri

Ottiene o imposta il percorso del servizio delle impostazioni Web.Gets or sets the Web settings service location.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty)

Ottiene la versione precedente della proprietà specificata.Gets the previous version of the specified property.

GetPropertyMetadata(String) GetPropertyMetadata(String) GetPropertyMetadata(String) GetPropertyMetadata(String)

Ottiene un insieme di metadati per tutte le proprietà recuperate dal servizio delle impostazioni Web specificato.Gets a collection of metadata for all properties retrieved from the specified Web settings service.

GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) 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.Returns the collection of settings property values for the specified application instance and settings property group.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

Inizializza il provider.Initializes the provider.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext)

Reimposta tutte le impostazioni utente sui valori predefiniti.Resets all user settings to their default values.

SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Imposta i valori del gruppo specificato di impostazioni delle proprietà.Sets the values of the specified group of property settings.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection)

Questo metodo non viene utilizzato da questa classe.This method is not used by this class.

Eventi

SettingsSaved SettingsSaved SettingsSaved SettingsSaved

Si verifica dopo il tentativo del provider di impostazioni di salvare i valori della proprietà nel servizio delle impostazioni Web.Occurs after the settings provider attempts to save the property values to the Web settings service.

Sicurezza

InheritanceDemand
per un'attendibilità totale per gli eredi.for full trust for inheritors. Questa classe non può essere ereditata da codice parzialmente attendibile.This class cannot be inherited by partially trusted code.

SecurityCriticalAttribute
richiede l'attendibilità totale per il chiamante immediato.requires full trust for the immediate caller. Questa classe non può essere utilizzata dal codice parzialmente attendibile o trasparente.This class cannot be used by partially trusted or transparent code.

Si applica a

Vedi anche