IApplicationSettingsProvider Gränssnitt

Definition

Definierar utökade funktioner för klientbaserade programinställningar.

public interface class IApplicationSettingsProvider
public interface IApplicationSettingsProvider
type IApplicationSettingsProvider = interface
Public Interface IApplicationSettingsProvider
Härledda

Kommentarer

Med arkitekturen för programinställningar kan du tillhandahålla en anpassad lagringsmekanism för programinställningar genom att skapa en anpassad inställningsprovider, som är en klass som härletts från SettingsProvider. En sådan klass innehåller de grundläggande funktionerna för att lagra och hämta egenskaper. Du kan dock lägga till ytterligare standardiserade funktioner genom att implementera IApplicationSettingsProvider gränssnittet i providern för anpassade inställningar. Det här gränssnittet innehåller tre metoder som främst gör det möjligt för inställningsprovidern att hantera ändringar i programversionen på ett mer intelligent sätt. Vanligtvis lagrar inställningsprovidern programinställningar för olika versioner av ett program separat för att förutse följande omständigheter:

  • Körning sida vid sida av olika versioner av ett program.

  • Behålla programinställningar när du uppgraderar ett program.

  • Återställa programinställningarna till deras standardvärden för den version som används för tillfället.

Klassen LocalFileSettingsProvider implementerar gränssnittet IApplicationSettingsProvider. Samma uppsättning metoder som ingår IApplicationSettingsProvider i finns också i ApplicationSettingsBase klassen, vilket möjliggör etablering av en fördefinierad kommunikationskanal mellan en programinställningsomslutning och dess inställningsprovider.

Note

Det här gränssnittet är valfritt. Om en provider inte implementerar det här gränssnittet misslyckas inställningsinfrastrukturen utan meddelande om den försöker komma åt någon av de metoder som definieras av det här gränssnittet.

Metoder

Name Description
GetPreviousVersion(SettingsContext, SettingsProperty)

Returnerar värdet för den angivna inställningsegenskapen för den tidigare versionen av samma program.

Reset(SettingsContext)

Återställer de programinställningar som är associerade med det angivna programmet till deras standardvärden.

Upgrade(SettingsContext, SettingsPropertyCollection)

Anger för providern att programmet har uppgraderats. Detta ger leverantören möjlighet att uppgradera sina lagrade inställningar efter behov.

Gäller för

Se även