Udostępnij za pośrednictwem


LocalFileSettingsProvider Klasa

Definicja

Zapewnia trwałość klas ustawień aplikacji.

public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider
public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider
type LocalFileSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider
Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider
Dziedziczenie
LocalFileSettingsProvider
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.

Dotyczy

Zobacz też