SettingsProvider Klasa
Definicja
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::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Dziedziczenie
- 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:
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) |
