LocalFileSettingsProvider.SetPropertyValues Methode
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.
Hiermee stelt u de waarden van de opgegeven groep eigenschapsinstellingen in.
public:
override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);public override void SetPropertyValues(System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unitPublic Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)Parameters
- context
- SettingsContext
Een SettingsContext beschrijving van het huidige toepassingsgebruik.
Een SettingsPropertyValueCollection weergave van de groep eigenschapsinstellingen die moeten worden ingesteld.
Uitzonderingen
Er is een instelling met gebruikersbereik aangetroffen, maar de huidige configuratie ondersteunt alleen instellingen voor toepassingsbereik.
– of –
Er is een algemene fout opgetreden bij het opslaan van de instellingen in het configuratiebestand.
Opmerkingen
Een wrapperklasse voor instellingen, afgeleid van ApplicationSettingsBase, bevat de Save methode, die wordt aangeroepen om de waarden van alle eigenschappen van de instellingen te behouden. Deze methode inventariseert alle instellingenproviders die zijn gekoppeld aan de eigenschappen van de instellingen en roept de SetPropertyValues methode voor elke SettingsProvider methode aan om de werkelijke serialisatiebewerking uit te voeren.
SetPropertyValues serialiseert elke eigenschap van toepassingsinstellingen in het gebruikersbereik afzonderlijk naar de bijbehorende toepassingsinstelling in het juiste user.config configuratiebestand.
De methode gebruikt standaard SetPropertyValues de volgende logische volgorde om het serialisatieschema te bepalen, afhankelijk van het type van de eigenschap Instellingen:
Als het type is gekoppeld aan TypeConverter een ConvertToString methode-implementatie, wordt deze conversie gebruikt.
XML-serialisatie wordt gebruikt.
U kunt echter een voorkeursserialisatiemechanisme opgeven met behulp van de SettingsSerializeAsAttribute. LocalFileSettingsProvider biedt geen ondersteuning voor binaire serialisatie in Visual Studio 2005.
Als een eigenschap voor instellingen met gebruikersbereik expliciet is ingesteld op de standaardwaarde, verwijdert de provider van de lokale bestandsinstellingen de vermelding voor de bijbehorende instelling uit het gebruikersconfiguratiebestand. De volgende leestoegang voor deze eigenschap gebruikt gewoon de standaardwaarde.
Caution
LocalFileSettingsProvider maakt geen gebruik van versleuteling om instellingen te behouden. Sla daarom geen wachtwoorden voor tekst zonder opmaak of andere gevoelige informatie op met deze provider zonder extra voorzorgsmaatregelen te nemen, zoals het afzonderlijk versleutelen van de gegevens in het configuratiebestand. Zie Configuratiegegevens versleutelen met beveiligde configuratie voor meer informatie.