Ustawienia technologii ClickOnce i aplikacji
Ustawienia aplikacji formularzy systemu Windows ułatwiają tworzenie, przechowywanie i obsługę niestandardowych preferencji aplikacji i użytkowników na kliencie. W poniższym dokumencie opisano sposób działania plików ustawień aplikacji w aplikacji ClickOnce oraz sposób migrowania ustawień przez użytkownika do następnej wersji.
Poniższe informacje dotyczą tylko domyślnego dostawcy ustawień aplikacji, LocalFileSettingsProvider klasy . Jeśli podasz dostawcę niestandardowego, ten dostawca określi, w jaki sposób przechowuje swoje dane i jak uaktualnia ustawienia między wersjami. Aby uzyskać więcej informacji na temat dostawców ustawień aplikacji, zobacz Architektura ustawień aplikacji.
Pliki ustawień aplikacji
Ustawienia aplikacji zużywają dwa pliki: <app.exe.config> i user.config, gdzie aplikacja jest nazwą aplikacji Windows Forms. Użytkownik.config jest tworzony na kliencie po raz pierwszy, gdy aplikacja przechowuje ustawienia o zakresie użytkownika. <z kolei plik app.exe.config> będzie istniał przed wdrożeniem, jeśli zdefiniujesz wartości domyślne ustawień. Program Visual Studio automatycznie uwzględni ten plik podczas korzystania z polecenia Publikuj . Jeśli tworzysz aplikację ClickOnce przy użyciu narzędzia Mage.exe lub MageUI.exe, upewnij się, że ten plik jest dołączony do innych plików aplikacji podczas wypełniania manifestu aplikacji.
Uwaga
W technologii ClickOnce dla platformy .NET Core 3.1 i .NET 5 lub nowszej użyj polecenia dotnet-mage.exe zamiast narzędzia Mage.exe. Aby uzyskać więcej informacji, zobacz ClickOnce dla platformy .NET.
W aplikacji Windows Forms, która nie została wdrożona przy użyciu technologii ClickOnce, plik app.exe.config> aplikacji< jest przechowywany w katalogu aplikacji, podczas gdy plik user.config jest przechowywany w folderze Documents i Ustawienia użytkownika. W aplikacji ClickOnce plik <app.exe.config> znajduje się w katalogu aplikacji wewnątrz pamięci podręcznej aplikacji ClickOnce, a plik user.config znajduje się w katalogu danych ClickOnce dla tej aplikacji.
Niezależnie od sposobu wdrażania aplikacji ustawienia aplikacji zapewniają bezpieczny dostęp do odczytu do pliku app.exe.config> oraz bezpieczny dostęp do odczytu/zapisu do pliku user.config.<
W aplikacji ClickOnce rozmiar plików konfiguracji używanych przez ustawienia aplikacji jest ograniczony przez rozmiar pamięci podręcznej ClickOnce. Aby uzyskać więcej informacji, zobacz Omówienie pamięci podręcznej ClickOnce.
.NET Core i .NET 5+
Obecnie zestaw .NET Core do opublikowania musi być podpisany przy użyciu pliku klucza silnej nazwy. Jeśli tak nie jest, ApplicationSettingsBase.Upgrade metoda nie kopiuje ustawień poprawnie po opublikowaniu nowej technologii ClickOnce. Możesz określić użycie silnej nazwy we właściwościach projektu .NET Core w obszarze opcji Kompiluj > silne nazewnictwo .
Uaktualnienia wersji
Podobnie jak każda wersja aplikacji ClickOnce jest odizolowana od wszystkich innych wersji, ustawienia aplikacji dla aplikacji ClickOnce są odizolowane od ustawień innych wersji. Gdy użytkownik uaktualnia do nowszej wersji aplikacji, ustawienia aplikacji porównują najnowsze (najwyżej numerowane) ustawienia wersji z ustawieniami dostarczonymi ze zaktualizowaną wersją i scala ustawienia z nowym zestawem plików ustawień.
W poniższej tabeli opisano sposób, w jaki ustawienia aplikacji decydują o tym, które ustawienia mają być skopiowane.
| Typ zmiany | Akcja uaktualniania |
|---|---|
| Ustawienie dodane do <pliku app.exe.config> | Nowe ustawienie jest scalane z bieżącą wersją <app.exe.config> |
| Ustawienie usunięte z <pliku app.exe.config> | Stare ustawienie jest usuwane z bieżącej <wersji app.exe.config> |
| Ustawienie jest zmieniane domyślne; ustawienie lokalne jest nadal ustawione na oryginalną wartość domyślną w pliku user.config | Ustawienie jest scalane z wartością user.config bieżącej wersji z nową wartością domyślną |
| Ustawienie jest zmieniane domyślne; ustawienie ustawione na wartość inną niż domyślna w pliku user.config | Ustawienie jest scalane z bieżącą wersją user.config z wartością inną niż domyślna zachowaną |
Jeśli utworzono własną klasę otoki ustawień aplikacji i chcesz dostosować logikę aktualizacji, możesz zastąpić metodę Upgrade .
Ustawienia technologii ClickOnce i roamingu
Technologia ClickOnce nie działa z ustawieniami roamingu, co umożliwia śledzenie pliku ustawień między maszynami w sieci. Jeśli potrzebujesz ustawień roamingu, musisz zaimplementować dostawcę ustawień aplikacji, który przechowuje ustawienia za pośrednictwem sieci, lub opracować własne niestandardowe klasy ustawień do przechowywania ustawień na komputerze zdalnym. Aby uzyskać więcej informacji na temat dostawców ustawień, zobacz Architektura ustawień aplikacji.