SettingsProvider Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Configuration

Zestaw:: System.Configuration.ConfigurationManager.dll

Zestaw:: System.dll

Pakiet:: System.Configuration.ConfigurationManager v6.0.0

Pakiet:: System.Configuration.ConfigurationManager v7.0.0

Pakiet:: System.Configuration.ConfigurationManager v8.0.0

Pakiet:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Źródło:: SettingsProvider.cs

Źródło:: SettingsProvider.cs

Źródło:: SettingsProvider.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Działa jako klasa bazowa do wyprowadzania dostawców ustawień niestandardowych w architekturze ustawień aplikacji.

public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBase

public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase

type SettingsProvider = class
    inherit ProviderBase

Public MustInherit Class SettingsProvider
Inherits ProviderBase

Dziedziczenie: Object

ProviderBase
SettingsProvider

Pochodne: System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

System.Web.Profile.ProfileProvider

Uwagi

Dostawca ustawień definiuje mechanizm przechowywania danych konfiguracji używanych w architekturze ustawień aplikacji. .NET Framework zawiera jednego dostawcę ustawień domyślnych, LocalFileSettingsProviderktóry przechowuje dane konfiguracji do lokalnego systemu plików. Można jednak utworzyć alternatywne mechanizmy przechowywania, korzystając z klasy abstrakcyjnej SettingsProvider . Dostawca używany przez klasę otoki jest określany przez dekorowanie klasy otoki za pomocą SettingsProviderAttributeklasy . Jeśli ten atrybut nie zostanie podany, zostanie użyty domyślny LocalFileSettingsProvideratrybut , .

Podczas tworzenia dostawcy ustawień niestandardowych należy co najmniej podać implementacje dla trzech metod tej klasy: GetPropertyValues, SetPropertyValues i ApplicationName.

W przypadku aplikacji klienckich można dodać bardziej ustandaryzowaną funkcjonalność do dostawcy niestandardowego IApplicationSettingsProvider , implementując również interfejs. Ten interfejs dubluje metody znalezione w ApplicationSettingsBase klasie, która umożliwia głównie obsługę wersji.

Zazwyczaj należy zaprojektować dostawców ustawień, aby uniknąć rywalizacji o zasoby magazynu, aby uniknąć rywalizacji o zasoby magazynu. Dostawcy powinni być również bezpieczni wątkowo, ponieważ mogą być wywoływani jednocześnie z wielu wystąpień otoki w jednej domenie aplikacji lub z wielu aplikacji w różnych domenach.

Co najmniej dostawca ustawień musi rozpoznawać trzy atrybuty — ApplicationScopedSettingAttribute, UserScopedSettingAttributei DefaultSettingValueAttribute. Aby uzyskać pełną listę atrybutów, które można zastosować do ustawień aplikacji, zobacz Atrybuty ustawień aplikacji. Dostawca ustawień niestandardowych powinien rozpoznawać atrybuty zastosowane do właściwości ustawień w następujący sposób:

Jeśli dostawca może spełnić żądanie dorozumiane przez atrybut, oczywiście powinien to zrobić.
Jeśli dostawca nie może spełnić żądania, powinien zignorować je dyskretnie.
Jeśli co najmniej dwa właściwości powodują konflikt; na przykład właściwość udekorowana elementem ApplicationScopedSettingAttribute i UserScopedSettingAttribute; dostawca powinien zgłosić wartość ConfigurationException.

Konstruktory

SettingsProvider()

Inicjuje wystąpienie klasy SettingsProvider.

Właściwości

ApplicationName	Pobiera lub ustawia nazwę aktualnie uruchomionej aplikacji.
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)

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)
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 konstruktora konfiguracji. (Odziedziczone po ProviderBase)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
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)

Dotyczy