Udostępnij za pośrednictwem


Zarządzanie ustawieniami aplikacji

Ustawienia aplikacji umożliwiają przechowywanie i pobieranie ustawień właściwości i inne informacje o aplikacji dynamicznie.Umożliwiają one również utrzymać niestandardowej aplikacji i preferencje użytkownika na komputerze klienckim.Często są to dane (na przykład ciągu połączenia), to krytyczne uruchamiania aplikacji i nie chcesz dołączyć bezpośrednio w kodzie aplikacji.Warto przechowywać dwa ciągi połączeń innej bazy danych i pobrać jeden z nich w czasie wykonywania na podstawie lokalizacji komputera.Lub można przechowywać ustawienia kolorów, a następnie pobrać je przy następnym uruchomieniu aplikacji.

Należy zauważyć, że ustawienia aplikacji są Visual Studio funkcja, która zastępuje funkcję właściwości dynamicznych we wcześniejszych wersjach.

Każde ustawienie aplikacji musi mieć unikatową nazwę.Nazwa może być dowolną kombinacją liter, liczb lub znaku podkreślenia, który nie uruchamia się z liczbą i nie może zawierać spacji.Nazwę można zmieniać za pomocą Name właściwości.

Ustawienia aplikacji mogą być przechowywane jako dowolny typ danych, który jest możliwy do serializacji XML lub ma TypeConverter który implementuje ToString/FromString.Są najbardziej typowych String, Integer, i Boolean, ale można również przechowywać wartości jako Color, Object, lub w ciągu połączenia.

Ustawienia aplikacji również zawierać wartość.Wartość jest ustawiona z wartość właściwość musi być zgodny z typem danych ustawienia.

Ponadto ustawienia aplikacji można powiązać właściwości formularza lub formantu w czasie projektowania.

Istnieją dwa rodzaje ustawień aplikacji, na podstawie zakresu:

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

  • Ustawienia zakresu użytkownika może służyć informacji, takich jak pozostające do ostatniej pozycji formularza lub preferencji czcionek.Użytkownicy mogą zmieniać tych wartości w czasie wykonywania.

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

Project system przechowuje ustawienia aplikacji w dwóch plikach XML: pliku app.config, który jest tworzony w czasie projektowania podczas tworzenia pierwszego ustawienia aplikacji; i plik user.config, który jest tworzony w czasie wykonywania, gdy użytkownik, który uruchamia aplikację zmienia wartość wszelkie 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ę tym.

Tworzenie ustawień aplikacji w czasie projektowania

Ustawienia aplikacji w czasie projektowania, można utworzyć na dwa sposoby: za pomocą Ustawienia stronę Project Designer, lub za pomocą Właściwości okna formularz lub formant, który pozwala powiązać ustawienie właściwości.

Podczas tworzenia ustawienie o zakresie aplikacji (na przykład ciąg połączenia bazy danych, lub odwołanie do zasobów serwera), Visual Studio zapisuje go w app.config z <applicationSettings> tag.(Ciągi połączenia są zapisywane w <connectionStrings> tag.)

Podczas tworzenia ustawienie zakresu użytkownika (na przykład domyślna czcionka, strona główna lub rozmiar okna), Visual Studio zapisuje go w app.config z <userSettings> tag.

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

Gdy ciągów połączenia są przechowywane w app.config, powinny podjąć środki ostrożności w celu uniknięcia ujawniających poufne informacje, takie jak hasła lub ścieżki serwera, w ciągu połączenia.

Jeśli informacje ciągu połączenia z zewnętrznego źródła, takie jak dostarczanie identyfikator użytkownika i hasło użytkownika należy uważać, aby zapewnić, że wartości, które używają do skonstruowania ciągu połączenia zawierają parametry ciągu połączenia dodatkowe, które zmienić zachowanie połączenia.

Należy rozważyć użycie funkcji chronione konfiguracji do szyfrowania poufnych informacji w pliku konfiguracyjnym.Zobacz Securing Connection Strings Aby uzyskać więcej informacji.

[!UWAGA]

Ponieważ żaden model pliku konfiguracji dla biblioteki klas ustawień aplikacji nie dotyczą projektów Biblioteka klas.Wyjątkiem jest Visual Studio Tools for Office DLL projektu, który może mieć pliku konfiguracji.

Przy użyciu niestandardowych ustawień plików

Pliki ustawień niestandardowych można dodać do projektu dla wygodne zarządzanie grupy ustawień.Ustawienia, które są zawarte w pojedynczym pliku są ładowane i zapisywane jako jednostka.Dlatego możliwość ustawienia są przechowywane w osobnych plików dla najczęściej używanych i rzadko używane grupy można zaoszczędzić czas ładowania i zapisywania ustawień.

Na przykład można dodać pliku, takie jak SpecialSettings.settings do swojego projektu.Podczas programu SpecialSettings klasy nie jest widoczny w My obszaru nazw, Widok Kod można odczytać pliku ustawień niestandardowych, który zawiera Partial Class SpecialSettings.

Projektant ustawienia najpierw szuka pliku Settings.settings, który tworzy system projektu; jest to domyślny plik wyświetlany Project Designer w Ustawienia kartę.Settings.Settings znajduje się w folderze Moje projektu dla Visual Basic projektów i w folderze właściwości dla Visual C# projektów.Project Designer następnie wyszukuje inne ustawienia pliki w folderze głównym projektu.W związku z tym należy umieścić plik ustawień niestandardowych tam.Dodaj plik .settings jest gdzie indziej w projekcie, Projektant projektu nie będzie mógł go znaleźć.

Dostęp do lub zmiana ustawień aplikacji w czasie wykonywania w programie Visual Basic

W Visual Basic projektów, ustawienia aplikacji w czasie wykonywania dostęp za pomocą My.Settings obiektu.Na Ustawienia kliknij opcję Widok Kod przycisk, aby wyświetlić plik Settings.vb.Definiuje Settings.vb Settings klasy, która pozwala obsłużyć zdarzenia te klasy ustawień: SettingChanging, PropertyChanged, SettingsLoaded, i SettingsSaving.Warto zauważyć, że Settings klasy w Settings.vb jest częściowe klasy, która wyświetla tylko posiadane przez użytkownika kod, nie całości wygenerowanej klasy.Aby uzyskać więcej informacji na temat dostępu do ustawień aplikacji za pomocą My.Settings obiektów, zobacz Dostęp do ustawień aplikacji (Visual Basic).

Wartości z zakresu użytkownika ustawień, które użytkownik zmieni się 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 zostały zmienione ustawienia zakresu użytkownika w czasie wykonywania, na przykład w aplikacji, testowania i chcesz przywrócić te ustawienia wartości domyślnych, kliknij Synchronizuj przycisk.

Zdecydowanie zaleca się używanie My.Settings obiektu i domyślny plik .settings do ustawienia dostępu.Jest tak, ponieważ projektant ustawienia można użyć do przypisywania właściwości do ustawienia, a ponadto, ustawienia użytkownika są zapisywane automatycznie przed zamknięcie aplikacji.Jednak Twój Visual Basic aplikacji dostęp do ustawień bezpośrednio.W takim przypadku trzeba uzyskać dostęp MySettings i użyć pliku niestandardowego .settings w katalogu głównym projektu.Należy również zapisać ustawienia użytkownika przed zakończeniem aplikacji, jak C# stosowania; jest to opisane w poniższej sekcji.

Dostęp do lub zmiana ustawień aplikacji w czasie wykonywania w Visual C#

W językach innych niż Visual Basic, takich jak Visual C#, musi mieć dostęp Settings klasy bezpośrednio, jak pokazano w następującym Visual C# przykład.

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

Należy jawnie wywołać Save metoda tej klasy otoki, aby utrwalić ustawienia użytkownika.Zazwyczaj to zrobić Closing obsługi zdarzenia w formularzu głównym.Następujące Visual C# przykładzie wywołanie Save metody.

Properties.Settings.Default.Save();

Szczególne przykład tworzenia nowego ustawienia aplikacji i powiązać właściwości formularza, zobacz Jak: Tworzenie ustawień aplikacji za pomocą projektanta.Aby uzyskać ogólne informacje dotyczące dostępu do ustawień aplikacji Settings klasy, zobacz Omówienie ustawień aplikacji.

Zobacz też

Koncepcje

Dostęp do ustawień aplikacji (Visual Basic)