SettingsProvider Třída

  • Reference

Definice

Obor názvů:
System.Configuration
Sestavení:
System.Configuration.ConfigurationManager.dll
Sestavení:
System.dll
Balíček:
System.Configuration.ConfigurationManager v6.0.0
Balíček:
System.Configuration.ConfigurationManager v7.0.0
Balíček:
System.Configuration.ConfigurationManager v8.0.0
Balíček:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
Zdroj:
SettingsProvider.cs
Zdroj:
SettingsProvider.cs
Zdroj:
SettingsProvider.cs

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

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:

  1. Pokud poskytovatel může splnit požadavek vyplývající z atributu , měl by to samozřejmě udělat.

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

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

Platí pro

Viz také