LocalFileSettingsProvider Klass

Definition

Namnområde:
System.Configuration
Sammansättning:
System.dll

Ger persistence för programinställningar klasser.

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
Arv
Object
ProviderBase
SettingsProvider
LocalFileSettingsProvider
Implementeringar
IApplicationSettingsProvider

Kommentarer

Ange providers definierar en mekanism för att lagra konfigurationsdata som används i arkitekturen för programinställningar. .NET Framework innehåller en enda standardinställningsprovider, LocalFileSettingsProvider, som lagrar konfigurationsdata till det lokala filsystemet. En egenskap för programinställningar eller en grupp med egenskaper är associerade med en specifik inställningsprovider med hjälp av SettingsProviderAttribute.

Vanligtvis har klientprogrammet inte uttryckligen åtkomst till den här klassen. I stället anropar programinställningsarkitekturen automatiskt lämplig inställningsprovider när dess tjänster krävs. Många av medlemmarna ApplicationSettingsBase i delegerar till exempel sitt arbete till den associerade inställningsprovidern.

LocalFileSettingsProvider bevarar inställningarna för konfigurationsfiler som har tillägget .config. Innehållet i konfigurationsfilerna är strukturerat som XML-dokument. Beroende på om inställningen är begränsad på programnivå eller användarnivå lagras konfigurationsdata som element i en <applicationSettings> eller en <userSettings> avsnittsgrupp. Var och en av dessa avsnittsgrupper representeras av en motsvarande AppSettingsSection eller ClientSettingsSection, respektive. Varje avsnittsobjekt ägs och administreras av en konfigurationsavsnittshanterare, som är ett objekt av typen IConfigurationSectionHandler.

Inställningar med programomfattning och standardinställningar för användaromfattning lagras i en fil med namnet application.exe.config, som skapas i samma katalog som den körbara filen. Programkonfigurationsinställningarna är skrivskyddade. Specifika användardata lagras i en fil med namnet user.config, som lagras under användarens hemkatalog. Om centrala profiler är aktiverade kan det finnas två versioner av användarkonfigurationsfilen. I så fall har posterna i den centrala versionen företräde framför duplicerade poster i den lokala användarkonfigurationsfilen.

Mer information om programinställningar finns i Programinställningar för Windows Forms.

Konstruktorer

Name Description
LocalFileSettingsProvider()

Initierar en ny instans av LocalFileSettingsProvider klassen.

Egenskaper

Name Description
ApplicationName

Hämtar eller anger namnet på det program som körs.
Description

Hämtar en kort, vänlig beskrivning som är lämplig för visning i administrativa verktyg eller andra användargränssnitt (UIs).

(Ärvd från ProviderBase)
Name

Hämtar det eget namn som används för att referera till providern under konfigurationen.

(Ärvd från ProviderBase)

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetPreviousVersion(SettingsContext, SettingsProperty)

Returnerar värdet för egenskapen namngivna inställningar för den tidigare versionen av samma program.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Returnerar samlingen med inställningsegenskapsvärden för den angivna programinstansen och egenskapsgruppen för inställningar.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Initialize(String, NameValueCollection)

Initierar providern.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Reset(SettingsContext)

Återställer alla egenskaper för programinställningar som är associerade med det angivna programmet till deras standardvärden.
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Anger värdena för den angivna gruppen med egenskapsinställningar.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
Upgrade(SettingsContext, SettingsPropertyCollection)

Försöker migrera tidigare användaromfattande inställningar från en tidigare version av samma program.

Gäller för

Se även