Udostępnij za pośrednictwem


SettingsProvider Klasa

Definicja

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
SettingsProvider
Pochodne

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:

  1. Jeśli dostawca może spełnić żądanie dorozumiane przez atrybut, oczywiście powinien to zrobić.

  2. Jeśli dostawca nie może spełnić żądania, powinien zignorować je dyskretnie.

  3. 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

Zobacz też