LocalFileSettingsProvider Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt persistentie voor toepassingsinstellingenklassen.
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- Overname
- Implementeringen
Opmerkingen
Instellingsproviders definiëren een mechanisme voor het opslaan van configuratiegegevens die worden gebruikt in de architectuur van de toepassingsinstellingen. .NET Framework bevat één standaardinstellingenprovider, LocalFileSettingsProvider, waarin configuratiegegevens worden opgeslagen in het lokale bestandssysteem. Een toepassingsinstellingeneigenschap of groep eigenschappen zijn gekoppeld aan een specifieke instellingenprovider via het gebruik van de SettingsProviderAttribute.
Normaal gesproken heeft het clientprogramma geen expliciete toegang tot deze klasse; In plaats daarvan roept de architectuur voor toepassingsinstellingen automatisch de juiste instellingenprovider aan wanneer de services zijn vereist. Veel van de leden van ApplicationSettingsBase het delegeren hun werk bijvoorbeeld aan de gekoppelde instellingenprovider.
LocalFileSettingsProvider behoudt instellingen voor configuratiebestanden met de extensie .config. De inhoud van configuratiebestanden is gestructureerd als XML-documenten. Afhankelijk van of de instelling is ingesteld op toepassingsniveau of op gebruikersniveau, worden de configuratiegegevens opgeslagen als elementen in een <applicationSettings> of een <userSettings> sectiegroep. Elk van deze sectiegroepen wordt vertegenwoordigd door respectievelijk een corresponderend AppSettingsSection of ClientSettingsSection, respectievelijk. Elk sectieobject is eigendom van en beheerd door een configuratiesectie-handler, een object van het type IConfigurationSectionHandler.
Instellingen voor toepassingsbereik en de standaardinstellingen voor gebruikersbereik worden opgeslagen in een bestand met de naam application.exe.config, dat wordt gemaakt in dezelfde map als het uitvoerbare bestand. Toepassingsconfiguratie-instellingen zijn alleen-lezen. Specifieke gebruikersgegevens worden opgeslagen in een bestand met de naam user.config, opgeslagen onder de basismap van de gebruiker. Als roamingprofielen zijn ingeschakeld, kunnen er twee versies van het gebruikersconfiguratiebestand bestaan. In dat geval hebben de vermeldingen in de zwervende versie voorrang op dubbele vermeldingen in het configuratiebestand van de lokale gebruiker.
Zie Application Settings for Windows Forms voor meer informatie over toepassingsinstellingen.
Constructors
| Name | Description |
|---|---|
| LocalFileSettingsProvider() |
Initialiseert een nieuw exemplaar van de LocalFileSettingsProvider klasse. |
Eigenschappen
| Name | Description |
|---|---|
| ApplicationName |
Hiermee haalt u de naam van de momenteel actieve toepassing op of stelt u deze in. |
| Description |
Hiermee krijgt u een korte, beschrijvende beschrijving die geschikt is voor weergave in beheerhulpprogramma's of andere gebruikersinterfaces (UIS's). (Overgenomen van ProviderBase) |
| Name |
Hiermee haalt u de beschrijvende naam op die wordt gebruikt om tijdens de configuratie naar de provider te verwijzen. (Overgenomen van ProviderBase) |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Retourneert de waarde van de eigenschap benoemde instellingen voor de vorige versie van dezelfde toepassing. |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Retourneert de verzameling eigenschapswaarden voor het opgegeven toepassingsexemplaren en de eigenschapsgroep instellingen. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| Initialize(String, NameValueCollection) |
Initialiseert de provider. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| Reset(SettingsContext) |
Hiermee worden alle eigenschappen van toepassingsinstellingen die aan de opgegeven toepassing zijn gekoppeld, opnieuw ingesteld op de standaardwaarden. |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Hiermee stelt u de waarden van de opgegeven groep eigenschapsinstellingen in. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Hiermee probeert u eerdere instellingen met gebruikersbereik te migreren van een eerdere versie van dezelfde toepassing. |