LocalFileSettingsProvider.SetPropertyValues Metoda

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Źródło:

LocalFileSettingsProvider.cs

Ustawia wartości określonej grupy ustawień właściwości.

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

Opis SettingsContext bieżącego użycia aplikacji.

values

SettingsPropertyValueCollection

Reprezentująca SettingsPropertyValueCollection grupę ustawień właściwości do ustawienia.

Wyjątki

ConfigurationErrorsException

Napotkano ustawienie o zakresie użytkownika, ale bieżąca konfiguracja obsługuje tylko ustawienia o zakresie aplikacji.

-lub-

Wystąpił ogólny błąd podczas zapisywania ustawień w pliku konfiguracji.

Uwagi

Otoka ustawień, pochodząca z ApplicationSettingsBaseklasy , zawiera metodę Save , która jest wywoływana w celu utrwalania wartości wszystkich jego właściwości ustawień. Ta metoda wylicza wszystkich dostawców ustawień skojarzonych z jej właściwościami ustawień i wywołuje metodę SetPropertyValues dla każdej z nich SettingsProvider , aby wykonać rzeczywistą operację serializacji.

SetPropertyValues Pojedynczo serializuje każdą właściwość ustawień aplikacji o zakresie użytkownika do odpowiedniego ustawienia aplikacji w odpowiednim user.config pliku konfiguracji.

Domyślnie SetPropertyValues metoda używa następującej sekwencji logicznej do określenia schematu serializacji w zależności od typu właściwości ustawienia:

1. Jeśli typ ma skojarzona TypeConverter z implementacją ConvertToString metody, ta konwersja jest używana.

2. Używana jest serializacja XML.

Można jednak określić preferowany mechanizm serializacji przy użyciu elementu SettingsSerializeAsAttribute. LocalFileSettingsProvider program nie obsługuje serializacji binarnej w programie Visual Studio 2005.

Jeśli właściwość ustawień o zakresie użytkownika zostanie jawnie ustawiona na wartość domyślną, dostawca ustawień plików lokalnych usunie wpis skojarzonego ustawienia z pliku konfiguracji użytkownika. Następny dostęp do odczytu dla tej właściwości będzie po prostu używać wartości domyślnej.

Przestroga

LocalFileSettingsProvider nie używa szyfrowania do utrwalania żadnych ustawień. W związku z tym nie należy przechowywać haseł zwykłych tekstu ani innych poufnych informacji korzystających z tego dostawcy bez podejmowania dodatkowych środków ostrożności, takich jak oddzielne szyfrowanie informacji w pliku konfiguracji. Aby uzyskać więcej informacji, zobacz Szyfrowanie informacji o konfiguracji przy użyciu chronionej konfiguracji.

Zobacz też

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