LocalFileSettingsProvider Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje trvalost pro třídy nastavení aplikace.
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
- Dědičnost
- Implementuje
Poznámky
Nastavení zprostředkovatelé definují mechanismus pro ukládání konfiguračních dat používaných v architektuře nastavení aplikace. Rozhraní .NET Framework obsahuje jednoho výchozího zprostředkovatele nastavení , LocalFileSettingsProviderkterý ukládá konfigurační data do místního systému souborů. Vlastnost nastavení aplikace nebo skupina vlastností jsou přidruženy ke konkrétnímu SettingsProviderAttributezprostředkovateli nastavení pomocí nástroje .
Klientský program obvykle explicitně nepřistupuje k této třídě; Architektura nastavení aplikace místo toho automaticky vyvolá příslušného zprostředkovatele nastavení, když jsou jeho služby vyžadovány. Například mnoho členů ApplicationSettingsBase deleguje svou práci na přidruženého poskytovatele nastavení.
LocalFileSettingsProvider zachová nastavení do konfiguračních souborů s příponou .config
. Obsah konfiguračních souborů je strukturován jako dokumenty XML. V závislosti na tom, jestli je nastavení vymezeno na úrovni aplikace nebo na úrovni uživatele, jsou konfigurační data uložena jako prvky ve <applicationSettings>
skupině oddílů nebo <userSettings>
ve skupině oddílů. Každá z těchto skupin oddílů je reprezentována odpovídajícími AppSettingsSection skupinami nebo ClientSettingsSection. Každý objekt oddílu vlastní a spravuje obslužná rutina konfiguračního oddílu, což je objekt typu IConfigurationSectionHandler.
Nastavení s oborem aplikace a výchozí nastavení s oborem uživatele jsou uložená v souboru s názvem application.exe.config
, který se vytvoří ve stejném adresáři jako spustitelný soubor. Nastavení konfigurace aplikace jsou jen pro čtení. Konkrétní uživatelská data jsou uložená v souboru s názvem user.config
, který je uložený v domovském adresáři uživatele. Pokud jsou cestovní profily povolené, můžou existovat dvě verze konfiguračního souboru uživatele. V takovém případě mají položky v roamingové verzi přednost před duplicitními položkami v konfiguračním souboru místního uživatele.
Další informace o nastavení aplikace najdete v tématu Nastavení aplikace pro model Windows Forms.
Konstruktory
LocalFileSettingsProvider() |
Inicializuje novou instanci LocalFileSettingsProvider třídy. |
Vlastnosti
ApplicationName |
Získá nebo nastaví název aktuálně spuštěné aplikace. |
Description |
Získá stručný popis vhodný pro zobrazení v nástrojích pro správu nebo jiných uživatelských rozhraních (UI). (Zděděno od ProviderBase) |
Name |
Získá popisný název použitý k odkaz na poskytovatele během konfigurace. (Zděděno od ProviderBase) |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetPreviousVersion(SettingsContext, SettingsProperty) |
Vrátí hodnotu pojmenované vlastnosti settings pro předchozí verzi stejné aplikace. |
GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Vrátí kolekci hodnot vlastností nastavení pro zadanou instanci aplikace a skupinu vlastností nastavení. |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
Initialize(String, NameValueCollection) |
Inicializuje poskytovatele. |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
Reset(SettingsContext) |
Obnoví výchozí hodnoty všech vlastností nastavení aplikace přidružených k zadané aplikaci. |
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Nastaví hodnoty zadané skupiny nastavení vlastností. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Upgrade(SettingsContext, SettingsPropertyCollection) |
Pokusí se migrovat předchozí nastavení oboru uživatele z předchozí verze stejné aplikace. |