SettingsProvider Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Fungeert als basisklasse voor het afleiden van aangepaste instellingenproviders in de architectuur van de toepassingsinstellingen.
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- Overname
- Afgeleid
Opmerkingen
Een instellingenprovider definieert het mechanisme voor het opslaan van configuratiegegevens die worden gebruikt in de architectuur van de toepassingsinstellingen. .NET Framework bevat één standaardinstellingenprovider, LocalFileSettingsProvider, waarin configuratiegegevens worden opgeslagen in het lokale bestandssysteem. U kunt echter alternatieve opslagmechanismen maken door de abstracte SettingsProvider klasse te gebruiken. De provider die door een wrapperklasse wordt gebruikt, wordt bepaald door de wrapper-klasse te decoreren met de SettingsProviderAttribute. Als dit kenmerk niet is opgegeven, wordt de standaardwaarde LocalFileSettingsProvider, gebruikt.
Wanneer u een provider voor aangepaste instellingen maakt, moet u minimaal implementaties opgeven voor de drie methoden van deze klasse: GetPropertyValuesen SetPropertyValuesApplicationName.
Voor clienttoepassingen kunt u meer gestandaardiseerde functionaliteit toevoegen aan een aangepaste provider door ook de IApplicationSettingsProvider interface te implementeren. Deze interface weerspiegelt methoden in de ApplicationSettingsBase klasse, die voornamelijk ondersteuning voor versiebeheer mogelijk maken.
Normaal gesproken moet u instellingenproviders ontwerpen voor één exemplaar om conflicten met opslagresources te voorkomen. Providers moeten ook thread-safe zijn omdat ze tegelijkertijd kunnen worden aangeroepen vanuit meerdere wrapper-exemplaren in één toepassingsdomein of vanuit meerdere toepassingen in verschillende domeinen.
Een instellingenprovider moet minimaal drie kenmerken herkennen : ApplicationScopedSettingAttribute, UserScopedSettingAttributeen DefaultSettingValueAttribute. Zie Kenmerken van toepassingsinstellingen voor een volledige lijst met kenmerken die kunnen worden toegepast op toepassingsinstellingen. Een aangepaste instellingsprovider moet kenmerken die zijn toegepast op instellingeneigenschappen op de volgende manier oplossen:
Als de provider kan voldoen aan de aanvraag die door het kenmerk wordt geïmpliceerd, moet dit duidelijk worden uitgevoerd.
Als de provider niet aan de aanvraag kan voldoen, moet deze op de achtergrond worden genegeerd.
Als twee of meer eigenschappen conflicteren; Bijvoorbeeld, een eigenschap die wordt ingericht met beide ApplicationScopedSettingAttribute en UserScopedSettingAttribute; de provider moet een ConfigurationException.
Constructors
| Name | Description |
|---|---|
| SettingsProvider() |
Initialiseert een exemplaar van de SettingsProvider klasse. |
Eigenschappen
| Name | Description |
|---|---|
| ApplicationName |
Hiermee haalt u de naam van de momenteel actieve toepassing op of stelt u deze in. |
| Description |
Hiermee krijgt u een korte, beschrijvende beschrijving die geschikt is voor weergave in beheerhulpprogramma's of andere gebruikersinterfaces (UIS's). (Overgenomen van ProviderBase) |
| Name |
Hiermee haalt u de beschrijvende naam op die wordt gebruikt om tijdens de configuratie naar de provider te verwijzen. (Overgenomen van ProviderBase) |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Retourneert de verzameling eigenschapswaarden van instellingen voor het opgegeven toepassingsexemplaren en de eigenschapsgroep instellingen. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| Initialize(String, NameValueCollection) |
Initialiseert de opbouwfunctie voor configuraties. (Overgenomen van ProviderBase) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Hiermee stelt u de waarden van de opgegeven groep eigenschapsinstellingen in. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |