SettingsProvider 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í.
Funguje jako základní třída pro odvození zprostředkovatelů vlastních nastavení v architektuře nastavení aplikace.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Dědičnost
- Odvozené
Poznámky
Zprostředkovatel nastavení definuje 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ů. Alternativní mechanismy úložiště však můžete vytvořit odvozením z abstraktní SettingsProvider třídy. Zprostředkovatel, který třída obálky používá, je určen dekorací třídy obálky pomocí SettingsProviderAttribute. Pokud tento atribut není zadaný, použije se výchozí LocalFileSettingsProviderhodnota .
Při vytváření vlastního zprostředkovatele nastavení musíte minimálně poskytnout implementace pro tři metody této třídy: GetPropertyValues, SetPropertyValues a ApplicationName.
U klientských aplikací můžete vlastního zprostředkovatele přidat standardizovanější funkce také implementací IApplicationSettingsProvider rozhraní. Toto rozhraní zrcadlí metody nalezené ve ApplicationSettingsBase třídě , která především umožňuje podporu správy verzí.
Obvykle byste měli navrhnout zprostředkovatele nastavení tak, aby byly v jedné instanci, aby nedocházelo ke kolizím prostředků úložiště. Zprostředkovatelé by také měli být bezpečná pro přístup z více vláken, protože je možné je volat současně z více instancí obálky v jedné doméně aplikace nebo z více aplikací v různých doménách.
Zprostředkovatel nastavení musí rozpoznat minimálně tři atributy – ApplicationScopedSettingAttribute, UserScopedSettingAttributea DefaultSettingValueAttribute. Úplný seznam atributů, které lze použít pro nastavení aplikace, najdete v tématu Atributy nastavení aplikace. Zprostředkovatel vlastního nastavení by měl přeložit atributy použité na vlastnosti nastavení následujícím způsobem:
Pokud poskytovatel může splnit požadavek vyplývající z atributu , měl by to samozřejmě udělat.
Pokud poskytovatel nemůže požadavek splnit, měl by ho ignorovat.
Pokud jsou v konfliktu dvě nebo více vlastností; Například vlastnost dekorována pomocí a ApplicationScopedSettingAttributeUserScopedSettingAttribute; zprostředkovatel by měl vyvolat ConfigurationException.
Konstruktory
| SettingsProvider() |
Inicializuje instanci třídy SettingsProvider. |
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í (UI). (Zděděno od ProviderBase) |
| Name |
Získá popisný název použitý k odkaz na zprostředkovatele 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) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Vrátí kolekci hodnot vlastností nastavení pro zadanou instanci aplikace a skupinu vlastností nastavení. |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| Initialize(String, NameValueCollection) |
Inicializuje tvůrce konfigurace. (Zděděno od ProviderBase) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| 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) |
