SettingsProvider Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Fungerar som en basklass för att härleda leverantörer av anpassade inställningar i programinställningsarkitekturen.
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- Arv
- Härledda
Kommentarer
En inställningsprovider definierar mekanismen för att lagra konfigurationsdata som används i arkitekturen för programinställningar. .NET Framework innehåller en enda standardinställningsprovider, LocalFileSettingsProvider, som lagrar konfigurationsdata till det lokala filsystemet. Du kan dock skapa alternativa lagringsmekanismer genom att härleda från den abstrakta SettingsProvider klassen. Providern som en omslutningsklass använder bestäms genom att omslutningsklassen SettingsProviderAttributedekoreras med . Om det här attributet inte anges används standardvärdet , LocalFileSettingsProvider.
När du skapar en provider för anpassade inställningar måste du minst tillhandahålla implementeringar för de tre metoderna i den här klassen: GetPropertyValues, SetPropertyValues och ApplicationName.
För klientprogram kan du lägga till mer standardiserade funktioner i en anpassad provider genom att även implementera IApplicationSettingsProvider gränssnittet. Det här gränssnittet speglar metoder som finns i ApplicationSettingsBase klassen, vilket främst möjliggör versionsstöd.
Normalt bör du utforma inställningsprovidrar så att de är instanser av en enda instans för att undvika konkurrens om lagringsresurser. Leverantörer bör också vara trådsäkra eftersom de kan anropas samtidigt från flera wrapper-instanser i en enda programdomän eller från flera program i olika domäner.
En inställningsprovider måste minst känna igen tre attribut – ApplicationScopedSettingAttribute, UserScopedSettingAttributeoch DefaultSettingValueAttribute. En fullständig lista över attribut som kan tillämpas på programinställningar finns i Attribut för programinställningar. En anpassad inställningsprovider bör matcha attribut som tillämpas på inställningsegenskaper på följande sätt:
Om providern kan uppfylla den begäran som antyds av attributet bör den naturligtvis göra det.
Om providern inte kan uppfylla begäran bör den ignorera den tyst.
Om två eller flera egenskaper är i konflikt; till exempel en egenskap som är dekorerad med både ApplicationScopedSettingAttribute och UserScopedSettingAttribute. Providern ska utlösa en ConfigurationException.
Konstruktorer
| Name | Description |
|---|---|
| SettingsProvider() |
Initierar en instans av SettingsProvider klassen. |
Egenskaper
| Name | Description |
|---|---|
| ApplicationName |
Hämtar eller anger namnet på det program som körs. |
| Description |
Hämtar en kort, vänlig beskrivning som är lämplig för visning i administrativa verktyg eller andra användargränssnitt (UIs). (Ärvd från ProviderBase) |
| Name |
Hämtar det eget namn som används för att referera till providern under konfigurationen. (Ärvd från ProviderBase) |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Returnerar samlingen med egenskapsvärden för inställningar för den angivna programinstansen och egenskapsgruppen för inställningar. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| Initialize(String, NameValueCollection) |
Initierar konfigurationsverktyget. (Ärvd från ProviderBase) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Anger värdena för den angivna gruppen med egenskapsinställningar. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |