LocalFileSettingsProvider 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.
Zapewnia trwałość klas ustawień aplikacji.
public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProviderpublic class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvidertype LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProviderPublic Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider- Dziedziczenie
- Implementuje
Uwagi
Ustawianie dostawców 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. Właściwość lub grupa właściwości ustawień aplikacji są skojarzone z określonym dostawcą ustawień przy użyciu elementu SettingsProviderAttribute.
Zazwyczaj program kliencki nie uzyskuje jawnego dostępu do tej klasy; zamiast tego architektura ustawień aplikacji automatycznie wywołuje odpowiedniego dostawcę ustawień, gdy jej usługi są wymagane. Na przykład wielu członków delegowania ApplicationSettingsBase swojej pracy do skojarzonego dostawcy ustawień.
LocalFileSettingsProvider utrwala ustawienia plików konfiguracji, które mają rozszerzenie .config. Zawartość plików konfiguracji jest ustrukturyzowana jako dokumenty XML. W zależności od tego, czy ustawienie ma zakres na poziomie aplikacji lub na poziomie użytkownika, dane konfiguracji są przechowywane odpowiednio jako elementy w <applicationSettings><userSettings> grupie lub sekcji. Każda z tych grup sekcji jest reprezentowana odpowiednio przez odpowiednie AppSettingsSection lub ClientSettingsSection, . Każdy obiekt sekcji jest własnością programu obsługi sekcji konfiguracji, który jest obiektem typu IConfigurationSectionHandler.
Ustawienia o zakresie aplikacji i domyślne ustawienia o zakresie użytkownika są przechowywane w pliku o nazwie application.exe.config, który jest tworzony w tym samym katalogu co plik wykonywalny. Ustawienia konfiguracji aplikacji są tylko do odczytu. Określone dane użytkownika są przechowywane w pliku o nazwie user.config, przechowywanym w katalogu głównym użytkownika. Jeśli profile roamingu są włączone, mogą istnieć dwie wersje pliku konfiguracji użytkownika. W takim przypadku wpisy w wersji mobilnej mają pierwszeństwo przed zduplikowanymi wpisami w pliku konfiguracji użytkownika lokalnego.
Aby uzyskać więcej informacji na temat ustawień aplikacji, zobacz Ustawienia aplikacji dla Windows Forms.
Konstruktory
| LocalFileSettingsProvider() |
Inicjuje nowe wystąpienie klasy LocalFileSettingsProvider. |
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) |
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Zwraca wartość właściwości nazwanych ustawień dla poprzedniej wersji tej samej aplikacji. |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Zwraca kolekcję ustawiania wartości właściwości 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 właściwości ustawień aplikacji skojarzone z określoną aplikacją 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) |
Próbuje przeprowadzić migrację poprzednich ustawień o zakresie użytkownika z poprzedniej wersji tej samej aplikacji. |
