Udostępnij za pośrednictwem


Zarządzanie ustawieniami aplikacji

Ustawienia aplikacji umożliwiają przechowywanie informacji o aplikacji dynamicznie.Ustawienia pozwalają na przechowywanie na komputerze klienckim informacji, które nie powinny być włączone do kodu aplikacji (na przykład parametrów połączenia), preferencji użytkownika i innych informacji potrzebnych w czasie wykonywania.

Ustawienia aplikacji zastępują właściwości dynamiczne stosowane we wcześniejszych wersjach programu Visual Studio.

Każde ustawienie aplikacji musi mieć unikatową nazwę.Nazwa może być dowolną kombinacją liter, cyfr lub znaku podkreślenia, która nie rozpoczyna się od liczby i nie zawiera spacji.Nazwę można zmienić za pomocą właściwości Name.

Ustawienia aplikacji mogą być przechowywane jako dowolny typ danych, który może być serializowany do XML lub posiada TypeConverter, który wdraża ToString/FromString.Najczęściej używane typy to String, Integer i Boolean, ale można również przechowywać wartości jako Color, Object lub parametry połączenia.

Ustawienia aplikacji również zawierają wartość.Wartość jest ustawiana za pomocą właściwości Wartość i musi być zgodna z typem danych ustawienia.

Ponadto ustawienia aplikacji może być powiązana z właściwością formularza lub formantu podczas projektowania.

Istnieją dwa rodzaje ustawień aplikacji w oparciu o zakres:

  • Ustawienia w zakresie aplikacji można uzyskać dla informacji takich jak adres URL usługi sieci Web lub ciąg połączenia bazy danych.Te wartości są skojarzone z aplikacją.Dlatego użytkownicy nie mogą zmieniać ich w czasie wykonywania.

  • Ustawienia z zakresu użytkownika mogą służyć jako źródło informacji np. dotyczących utrwalenia ostatniej pozycji formularza lub preferencji czcionek.Użytkownicy mogą zmieniać te wartości w czasie wykonywania.

Typ ustawienia można zmienić za pomocą właściwości Zakres.

System projektów przechowuje ustawienia aplikacji w dwóch plikach XML: pliku app.config, który jest tworzony w czasie projektowania podczas tworzenia pierwszego ustawienia aplikacji; i w pliku user.config, który jest tworzony w czasie wykonywania, gdy użytkownik uruchamiający aplikację zmienia wartość dowolnego ustawienia użytkownika.Należy zauważyć, że zmiany w ustawieniach użytkownika nie są zapisywane na dysku, chyba że aplikacja specjalnie wywołuje metodę w tym celu.

Tworzenie ustawień aplikacji w czasie projektowania

Podczas projektowania, tworzenia ustawienia aplikacji na dwa sposoby: za pomocą Ustawienia strony Designer projektu, lub za pomocą właściwości okna dla formularza lub formantu, dzięki czemu można powiązać ustawienie właściwości.

Podczas tworzenia ustawień o zakresie aplikacji (na przykład parametrów połączenia bazy danych lub odwołania do zasobów serwera) program Visual Studio zapisuje je w pliku app.config za pomocą znacznika <applicationSettings>.(Ciągi połączeń są zapisywane pod znacznikiem <connectionStrings>.)

Podczas tworzenia ustawień z zakresu użytkownika (na przykład czcionki domyślnej, strony głównej i rozmiaru okna) program Visual Studio zapisuje je w pliku app.config przy użyciu znacznika <userSettings>.

Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

Kiedy przechowujesz ciągi połączeń w app.config, należy zachować środki ostrożności, aby uniknąć ujawnienia poufnych informacji, takich jak hasła lub ścieżki serwera w ciągu połączenia.

Jeśli skorzystasz z parametrów połączenia z zewnętrznego źródła, takiego jak podanie identyfikatora użytkownika i hasła przez użytkownika, musisz być ostrożnym, aby zapewnić, że wartości, które są użyte do skonstruowania parametrów połączenia, nie zawierają dodatkowych parametrów połączenia, które zmieniają zachowanie połączenia.

Należy rozważyć użycie funkcji konfiguracji chronionej do szyfrowania poufnych informacji w pliku konfiguracyjnym.Zobacz Protecting Connection Information uzyskać więcej informacji.

[!UWAGA]

Ponieważ nie istnieje żaden model pliku konfiguracji dla bibliotek klas, ustawienia aplikacji nie odnoszą się do projektów biblioteki klas.Wyjątek stanowi projekt biblioteki DLL narzędzi Visual Studio Tools for Office, który może mieć plik konfiguracji.

Korzystanie z plików ustawień niestandardowych

Można dodać pliki niestandardowych ustawień do projektu, aby móc wygodniej zarządzać grupami ustawień.Ustawienia zawarte w pojedynczym pliku są ładowane i zapisywane jako jednostka.Dlatego możliwość przechowywania w osobnych plikach ustawień dla często i rzadko używanych grup może skrócić czas ładowania i zapisywania ustawień.

Można na przykład dodać plik taki jak SpecialSettings.settings do swojego projektu.Podczas gdy Twoja klasa SpecialSettings nie jest ujawniona w My przestrzeni nazw, Wyświetl kod może odczytać plik ustawień niestandardowych, który zawiera Partial Class SpecialSettings.

Projektant ustawień najpierw szuka pliku Settings.settings, który tworzy system projektu; jest to domyślny plik wyświetlany przez Projektanta projektu na karcie Ustawienia.Plik Settings.settings znajduje się w folderze Mój projekt w przypadku projektów Visual Basic i w folderze Właściwości w przypadku projektów Visual C#.Następnie Projektant projektu wyszukuje inne pliki ustawień w folderze głównym projektu.Dlatego należy umieścić tam plik ustawień niestandardowych.Po dodaniu pliku .settings w innym miejscu w projekcie Projektant projektu nie będzie mógł go znaleźć.

Uzyskiwanie dostępu do lub zmiana ustawień aplikacji w czasie wykonywania w języku Visual Basic

W Visual Basic projektów, można uzyskać dostęp ustawienia aplikacji w czasie wykonywania za pomocą My.Settings obiektu.Na stronie Ustawienia kliknij przycisk Wyświetl kod, aby wyświetlić plik Settings.vb.Plik Settings.vb definiuje klasę Settings, która umożliwia obsługę następujących zdarzeń w klasie ustawień: SettingChanging, PropertyChanged, SettingsLoaded i SettingsSaving.Należy zauważyć, że Settings klasa w Settings.vb jest częściową klasą, która wyświetla tylko włany kod użytkownia, a nie całje wygenerowanej klasy.Aby uzyskać więcej informacji na temat uzyskiwania dostępu do ustawień aplikacji za pomocą My.Settings obiektów, zobacz Uzyskiwanie dostępu do ustawień aplikacji (Visual Basic).

Wartości dowolnych ustawień zakresu użytkownika, które użytkownik zmienia w czasie wykonywania (na przykład położenie formularza), są przechowywane w pliku user.config.Należy zauważyć, że wartości domyślne są nadal zapisywane w app.config.

Jeśli zmieniono żadnych ustawień z zakresu użytkownika w czasie wykonywania, na przykład w aplikacji, testowania i chcesz zresetować te ustawienia do wartości domyślnych, kliknij przycisk Synchronizuj przycisku.

Firma Microsoft zdecydowanie zaleca używanie obiektu My.Settings i domyślnego pliku .settings do uzyskiwania dostępu do ustawień.To dlatego, że projektant ustawień służy do przypisywania właściwości do ustawień i, dodatkowo, ustawienia użytkownika są zapisywane automatycznie przed zamknięciem aplikacji.Jednak aplikacja programu Visual Basic może uzyskać dostęp do ustawień bezpośrednio.W takim przypadku trzeba uzyskać dostępdo MySettings klasy i użyć pliku niestandardowego .settings w katalogu głównym projektu.Należy również zapisać ustawienia użytkownika przed zakończeniem aplikacji w taki sam sposób jak dla aplikacji C#; jest to opisane w poniższej sekcji.

Uzyskiwanie dostępu do lub zmiana ustawień aplikacji w czasie wykonywania w języku Visual C#

W językach innych niż Visual Basic, takich jak Visual C#, musisz uzyskać dostęp do klasy Settings bezpośrednio, jak pokazano w następującym przykładzie dla języka Visual C# .

Properties.Settings.Default.FirstUserSetting = "abc";

Należy także jawnie wywołać metodę Save tej klasy otoki, aby utrwalić ustawienia użytkownika.Zwykle robi się to obsłudze zdarzeń Closing formularza głównego.Poniższy przykład Visual C# ilustruje sposób wywoływania metody Save.

Properties.Settings.Default.Save();

Dla określonych przykładem sposób tworzenia nowego ustawienia aplikacji i powiązać je z właściwości na formularzu, zobacz Porady: tworzenie ustawień aplikacji przy użyciu narzędzia Projektant.Aby uzyskać więcej ogólnych informacji na temat uzyskiwania dostępu do ustawień aplikacji za pomocą Settings zobacz Przegląd ustawień aplikacji.Informacji o iteracji w ustawieniach, zobacz wpis na forum.

Zobacz też

Koncepcje

Uzyskiwanie dostępu do ustawień aplikacji (Visual Basic)