SettingsProvider Třída

  • Reference

Definice

Obor názvů:
System.Configuration
Sestavení:
System.Configuration.ConfigurationManager.dll
Sestavení:
System.dll

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::ProviderBase
public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase
type SettingsProvider = class
    inherit ProviderBase
Public MustInherit Class SettingsProvider
Inherits ProviderBase
Dědičnost
Object
ProviderBase
SettingsProvider
Odvozené

Poznámky

Poskytovatel 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í, 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čena dekorací třídy obálky s SettingsProviderAttribute. Pokud tento atribut není zadaný, použije se výchozí hodnota LocalFileSettingsProvider.

Při vytváření vlastního zprostředkovatele nastavení minimálně musíte poskytnout implementace pro tři metody této třídy: GetPropertyValuesa SetPropertyValues ApplicationName.

U klientských aplikací můžete vlastnímu poskytovateli přidat standardizované funkce také implementací IApplicationSettingsProvider rozhraní. Toto rozhraní zrcadlí metody nalezené ve ApplicationSettingsBase třídě, což hlavně umožňuje podporu správy verzí.

Obvykle byste měli navrhnout poskytovatele nastavení tak, aby se zabránilo kolizí prostředků úložiště s jednou instancí. Poskytovatelé by také měli být v bezpečí z více vláken, protože je lze 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 pro nastavení aplikace, naleznete v tématu Nastavení Atributy aplikace. Poskytovatel vlastního nastavení by měl překládat atributy použité u vlastností nastavení následujícím způsobem:

  1. Pokud poskytovatel může splnit požadavek odvozený atributem, měl by to samozřejmě provést.

  2. Pokud poskytovatel nemůže požadavek splnit, měl by ho bezobslužně ignorovat.

  3. 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

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ý, přátelský 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 odkazování 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í 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()

Type Získá aktuální instanci.

(Zděděno od Object)
Initialize(String, NameValueCollection)

Inicializuje tvůrce konfigurace.

(Zděděno od ProviderBase)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru 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)

Platí pro

Viz také