Udostępnij za pośrednictwem


ClientSettingsProvider Klasa

Definicja

Umożliwia aplikacjom opartym na systemie Windows pobieranie ustawień użytkownika z usługi ustawień sieci 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
Dziedziczenie
ClientSettingsProvider
Atrybuty
Implementuje

Przykłady

Poniższy przykładowy kod pokazuje, jak za pomocą tego zdarzenia wyświetlić listę ustawień, które nie zostały pomyślnie zapisane.

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

Uwagi

Za pomocą usług aplikacji klienckich można pobrać ustawienia użytkownika z istniejącej usługi ustawień sieci Web, konfigurując aplikację ClientSettingsProvider do korzystania z klasy . Po skonfigurowaniu można pobrać i ustawić ustawienia użytkownika za pomocą klasy ustawień aplikacji pochodnej ApplicationSettingsBase i skonfigurowanej do używania ClientSettingsProvider klasy. Możesz użyć programu Visual Studio do wygenerowania Settings klasy dla projektu (dostępnej jako Properties.Settings.Default w języku C# i My.Settings w Visual Basic). Aby uzyskać więcej informacji na temat ustawień aplikacji, zobacz Omówienie ustawień aplikacji.

Bieżący element można pobrać ClientSettingsProvider za pomocą ApplicationSettingsBase.Providers właściwości przy użyciu w pełni kwalifikowanej ClientSettingsProvider nazwy klasy jako klucza. Dostawca można również pobrać za pośrednictwem SettingsLoadedEventArgs.Provider właściwości podczas obsługi ApplicationSettingsBase.SettingsLoaded zdarzenia.

Uwaga

Ta klasa zawiera klasę SecurityCriticalAttribute na poziomie, która ma zastosowanie do wszystkich elementów członkowskich klasy. Wyjątek czasu wykonywania jest zgłaszany, jeśli bezpośredni obiekt wywołujący jest przezroczysty lub częściowo zaufany. Aby uzyskać więcej informacji na temat typów i elementów członkowskich o krytycznym znaczeniu dla zabezpieczeń, zobacz Security-Transparent Code( Poziom 2).

Uwaga

Ta klasa zawiera żądanie dziedziczenia na poziomie klasy, które ma zastosowanie do wszystkich elementów członkowskich. Wartość A SecurityException jest zgłaszana, gdy klasa pochodna nie ma uprawnień pełnego zaufania. Aby uzyskać szczegółowe informacje na temat wymagań dotyczących zabezpieczeń, zobacz Łączenie żądań i żądań dziedziczenia.

Konstruktory

ClientSettingsProvider()

Inicjuje nowe wystąpienie klasy ClientSettingsProvider.

Właściwości

ApplicationName

Ta właściwość nie jest używana przez tę klasę.

Description

Pobiera krótki, przyjazny opis odpowiedni do wyświetlania w narzędziach administracyjnych lub innych interfejsach użytkownika (UI).

(Odziedziczone po ProviderBase)
Name

Pobiera przyjazną nazwę używaną do odwoływania się do dostawcy podczas konfiguracji.

(Odziedziczone po ProviderBase)
ServiceUri

Pobiera lub ustawia lokalizację usługi ustawień sieci Web.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetPreviousVersion(SettingsContext, SettingsProperty)

Pobiera poprzednią wersję określonej właściwości.

GetPropertyMetadata(String)

Pobiera kolekcję metadanych dla wszystkich właściwości pobranych z określonej usługi ustawień sieci Web.

GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Zwraca kolekcję wartości właściwości ustawień dla określonego wystąpienia aplikacji i grupy właściwości ustawień.

GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
Initialize(String, NameValueCollection)

Inicjuje dostawcę.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
Reset(SettingsContext)

Resetuje wszystkie ustawienia użytkownika do ich wartości domyślnych.

SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Ustawia wartości określonej grupy ustawień właściwości.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
Upgrade(SettingsContext, SettingsPropertyCollection)

Ta metoda nie jest używana przez tę klasę.

Zdarzenia

SettingsSaved

Występuje po próbie zapisania wartości właściwości przez dostawcę ustawień sieci Web.

Dotyczy

Zobacz też