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. .NET Framework obsahuje jednoho výchozího zprostředkovatele nastavení LocalFileSettingsProvider, který ukládá konfigurační data do místního systému souborů. Můžete však vytvořit alternativní mechanismy úložiště odvozením z abstraktní SettingsProvider třídy. Zprostředkovatel, který třída obálky používá, je určena dekorací obálky třídy s SettingsProviderAttribute. Pokud tento atribut není zadaný, použije se výchozí LocalFileSettingsProviderhodnota .
Při vytváření vlastního nastavení zprostředkovatele, minimálně musíte poskytnout implementace pro tři metody této třídy: GetPropertyValuesSetPropertyValues a ApplicationName.
U klientských aplikací můžete k vlastnímu poskytovateli přidat standardizované funkce také implementací IApplicationSettingsProvider rozhraní. Toto rozhraní zrcadlí metody nalezené ve ApplicationSettingsBase třídě, což zejména umožňuje podporu správy verzí.
Obvykle byste měli navrhnout poskytovatele nastavení tak, aby byly jedno instance, aby nedocházelo ke kolizí prostředků úložiště. Zprostředkovatelé by také měli být v bezpečí 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.
Minimálně musí poskytovatel nastavení rozpoznat tři atributy – ApplicationScopedSettingAttribute, UserScopedSettingAttributea DefaultSettingValueAttribute. Úplný seznam atributů, které lze použít v nastavení aplikace, naleznete v tématu Atributy nastavení aplikace. Zprostředkovatel vlastního nastavení by měl přeložit atributy použité u vlastností 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ě provést.
Pokud poskytovatel nemůže požadavek splnit, měl by ho bezobslužně ignorovat.
Pokud dojde ke konfliktu dvou nebo více vlastností; Například vlastnost, která je zdobena oběma ApplicationScopedSettingAttribute a UserScopedSettingAttribute; poskytovatel by měl vyvolat ConfigurationException.
Konstruktory
| Name | Description |
|---|---|
| SettingsProvider() |
Inicializuje instanci SettingsProvider 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) |
| 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 tvůrce konfigurace. (Zděděno od ProviderBase) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (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) |
