LocalFileSettingsProvider 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:: LocalFileSettingsProvider.cs

Źródło:: LocalFileSettingsProvider.cs

Źródło:: LocalFileSettingsProvider.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.

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: Object

ProviderBase

SettingsProvider
LocalFileSettingsProvider

Implementuje: IApplicationSettingsProvider

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