SettingsProvider Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Alaposztályként szolgál az egyéni beállítások szolgáltatóinak az alkalmazásbeállítások architektúrájában való származtatásához.
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- Öröklődés
- Származtatott
Megjegyzések
A beállításszolgáltató határozza meg az alkalmazásbeállítások architektúrájában használt konfigurációs adatok tárolásának mechanizmusát. A .NET-keretrendszer egyetlen alapértelmezett beállításszolgáltatót (LocalFileSettingsProvider) tartalmaz, amely a konfigurációs adatokat a helyi fájlrendszerben tárolja. Alternatív tárolási mechanizmusokat azonban létrehozhat az absztrakt SettingsProvider osztályból származtatva. A burkolóosztály által használt szolgáltatót a burkolóosztály és a SettingsProviderAttribute. Ha ez az attribútum nincs megadva, a rendszer az alapértelmezett LocalFileSettingsProviderértéket használja.
Egyéni beállításszolgáltató létrehozásakor legalább az osztály három metódusának implementációit kell megadnia: GetPropertyValuesés SetPropertyValuesApplicationName.
Az ügyfélalkalmazások esetében a felület implementálásával szabványosabb funkciókat adhat hozzá egy IApplicationSettingsProvider egyéni szolgáltatóhoz. Ez az interfész tükrözi az ApplicationSettingsBase osztályban található metódusokat, amelyek főként a verziószámozás támogatását teszik lehetővé.
A tárolóerőforrás-versengés elkerülése érdekében általában olyan beállításszolgáltatókat kell megterveznie, amelyek egypéldányosak. A szolgáltatóknak azért is biztonságosnak kell lenniük, mert egyszerre hívhatók egy alkalmazástartomány több burkolópéldányából vagy több különböző tartományban lévő alkalmazásból.
A beállításszolgáltatónak legalább három attribútumot kell felismernie : ApplicationScopedSettingAttribute, UserScopedSettingAttributeés DefaultSettingValueAttribute. Az alkalmazásbeállításokra alkalmazható attribútumok teljes listáját az Alkalmazásbeállítások attribútumai című témakörben találja. Az egyéni beállításszolgáltatónak a következő módon kell feloldania a beállítástulajdonságokra alkalmazott attribútumokat:
Ha a szolgáltató teljesíteni tudja az attribútum által sugallt kérést, nyilvánvalóan ezt kell tennie.
Ha a szolgáltató nem tudja teljesíteni a kérést, csendesen figyelmen kívül kell hagynia.
Ha két vagy több tulajdonság ütközik; például egy tulajdonság, amely mindkettővel ApplicationScopedSettingAttribute van díszítve, és UserScopedSettingAttribute; a szolgáltatónak egy ConfigurationException.
Konstruktorok
| Name | Description |
|---|---|
| SettingsProvider() |
Inicializálja az osztály egy példányát SettingsProvider . |
Tulajdonságok
| Name | Description |
|---|---|
| ApplicationName |
Lekéri vagy beállítja a jelenleg futó alkalmazás nevét. |
| Description |
Rövid, rövid leírást kap, amely alkalmas a felügyeleti eszközökben vagy más felhasználói felületeken való megjelenítésre. (Öröklődés forrása ProviderBase) |
| Name |
Lekéri a szolgáltatóra való hivatkozáshoz használt rövid nevet a konfiguráció során. (Öröklődés forrása ProviderBase) |
Metódusok
| Name | Description |
|---|---|
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
A megadott alkalmazáspéldány és a beállítások tulajdonságcsoport beállítástulajdonság-értékeinek gyűjteményét adja vissza. |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| Initialize(String, NameValueCollection) |
Inicializálja a konfigurációszerkesztőt. (Öröklődés forrása ProviderBase) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
A megadott tulajdonságbeállítások csoportjának értékeit állítja be. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
