LocalFileSettingsProvider.SetPropertyValues Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v9.0.0-preview.5.24306.7

Zdroj:

LocalFileSettingsProvider.cs

Nastaví hodnoty zadané skupiny nastavení vlastností.

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 -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

Parametry

context

SettingsContext

Popis SettingsContext aktuálního využití aplikace.

values

SettingsPropertyValueCollection

Představuje SettingsPropertyValueCollection skupinu nastavení vlastnosti, která se má nastavit.

Výjimky

ConfigurationErrorsException

Bylo zjištěno nastavení s oborem uživatele, ale aktuální konfigurace podporuje pouze nastavení v oboru aplikace.

-nebo-

Při ukládání nastavení do konfiguračního souboru došlo k obecné chybě.

Poznámky

Třída obálky nastavení odvozená z ApplicationSettingsBaseobsahuje metodu Save , která je volána k zachování hodnot všech vlastností nastavení. Tato metoda provede výčet všech zprostředkovatelů nastavení přidružených k jeho vlastnostem nastavení a volá metodu SetPropertyValues pro každý SettingsProvider k provedení skutečné operace serializace.

SetPropertyValues individuálně serializuje každou vlastnost nastavení aplikace v oboru uživatele na odpovídající nastavení aplikace v příslušném user.config konfiguračním souboru.

Ve výchozím nastavení SetPropertyValues metoda používá následující logickou sekvenci k určení schématu serializace v závislosti na typu vlastnosti nastavení:

1. Pokud má typ přidružený TypeConverter k implementaci ConvertToString metody, použije se tento převod.

2. Serializace XML se používá.

Můžete však určit upřednostňovaný mechanismus serializace pomocí .SettingsSerializeAsAttribute LocalFileSettingsProvider nepodporuje binární serializaci v sadě Visual Studio 2005.

Pokud je vlastnost nastavení v oboru uživatele nastavena zpět na výchozí hodnotu explicitně, pak zprostředkovatel nastavení místního souboru odebere položku pro přidružené nastavení z konfiguračního souboru uživatele. Další přístup pro čtení pro tuto vlastnost bude jednoduše používat výchozí hodnotu.

Upozornění

LocalFileSettingsProvider nepoužívá šifrování k zachování jakýchkoli nastavení. Proto neuchovávejte hesla ve formátu prostého textu nebo jiné citlivé informace pomocí tohoto zprostředkovatele, aniž byste podnikli další opatření, jako je například samostatné šifrování informací v konfiguračním souboru. Další informace najdete v tématu Šifrování konfiguračních informací pomocí chráněné konfigurace.

Viz také

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute