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::IApplicationSettingsProviderpublic class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvidertype LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProviderPublic Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider- Dědičnost
- Implementuje
Poznámky
Nastavení zprostředkovatelů definuje mechanismus pro ukládání konfiguračních dat používaných v architektuře nastavení aplikace. .NET Framework obsahuje jednoho výchozího zprostředkovatele nastavení LocalFileSettingsProvider, který 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 poskytovateli nastavení prostřednictvím použití SettingsProviderAttribute.
Klientský program obvykle nemá explicitně přístup k této třídě; Architektura nastavení aplikace automaticky vyvolá příslušného zprostředkovatele nastavení, pokud jsou požadovány jeho služby. Například mnoho členů delegování ApplicationSettingsBase své práce na přidruženého zprostředkovatele nastavení.
LocalFileSettingsProvider zachová nastavení konfiguračních souborů, které mají příponu .config. Obsah konfiguračních souborů je strukturovaný jako dokumenty XML. V závislosti na tom, jestli je nastavení vymezeno na úrovni aplikace nebo na úrovni uživatele, se konfigurační data ukládají jako prvky v rámci <applicationSettings> skupiny oddílů nebo <userSettings> skupiny oddílů. Každá z těchto skupin oddílů je reprezentována odpovídajícím AppSettingsSection nebo ClientSettingsSection, v uvedeném pořadí. Každý objekt oddílu je vlastněný a spravován obslužnou rutinou oddílu konfigurace, což je objekt typu IConfigurationSectionHandler.
Nastavení s oborem aplikace a výchozí nastavení s oborem uživatele jsou uloženy v souboru s názvem application.exe.config, který je vytvořen ve stejném adresáři jako spustitelný soubor. Nastavení konfigurace aplikace je jen pro čtení. Konkrétní uživatelská data se ukládají do souboru s názvem user.config, který je uložený v domovském adresáři uživatele. Pokud jsou povolené cestovní profily, můžou existovat dvě verze konfiguračního souboru uživatele. V takovém případě mají položky v cestovní verzi přednost před duplicitními položkami v místním konfiguračním souboru uživatele.
Další informace o nastavení aplikace najdete v tématu Nastavení aplikace pro model Windows Forms.
Konstruktory
| Name | Description |
|---|---|
| LocalFileSettingsProvider() |
Inicializuje novou instanci LocalFileSettingsProvider třídy. |
Vlastnosti
| Name | Description |
|---|---|
| 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 odkazování na zprostředkovatele během konfigurace. (Zděděno od ProviderBase) |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Vrátí hodnotu pojmenované vlastnosti nastavení 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á Type aktuální instance. (Zděděno od Object) |
| Initialize(String, NameValueCollection) |
Inicializuje poskytovatele. |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| Reset(SettingsContext) |
Obnoví všechny vlastnosti nastavení aplikace přidružené k zadané aplikaci na výchozí hodnoty. |
| 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í uživatelsky vymezená nastavení z předchozí verze stejné aplikace. |
