Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Windows Forms alkalmazásbeállításai megkönnyítik az egyéni alkalmazások és felhasználói beállítások létrehozását, tárolását és karbantartását az ügyfélen. Az alábbi dokumentum bemutatja, hogyan működnek az alkalmazásbeállítások fájljai a ClickOnce-alkalmazásokban, és hogy a ClickOnce hogyan migrálja a beállításokat, amikor a felhasználó a következő verzióra frissít.
Az alábbi információk csak az alapértelmezett alkalmazásbeállítás-szolgáltatóra, az LocalFileSettingsProvider osztályra vonatkoznak. Ha egyéni szolgáltatót ad meg, az a szolgáltató határozza meg, hogyan tárolja az adatait, és hogyan frissíti a beállításokat a verziók között. További információ az alkalmazásbeállítások szolgáltatóiról: Alkalmazásbeállítások architektúrája.
Alkalmazásbeállítások fájljai
Az alkalmazásbeállítások két fájlt használnak: <az alkalmazás>.exe.config és user.config, ahol az alkalmazás a Windows Forms-alkalmazás neve. user.config akkor jön létre az ügyfélen, amikor az alkalmazás először tárolja a felhasználói hatókörű beállításokat. <az alkalmazás>.exe.configaz üzembe helyezés előtt létezni fog, ha a beállítások alapértelmezett értékeit határozza meg. A Visual Studio automatikusan belefoglalja ezt a fájlt a Közzététel parancs használatakor. Ha Mage.exevagy MageUI.exehasználatával hozza létre a ClickOnce-alkalmazást, az alkalmazásjegyzék feltöltésekor győződjön meg arról, hogy ez a fájl szerepel az alkalmazás többi fájljában.
Megjegyzés:
A .NET Core 3.1 és .NET 5 vagy újabb verzióihoz készült ClickOnce használata esetén a Mage.exe helyett a dotnet-mage.exe programot használja. További információ: ClickOnce for .NET.
A ClickOnce használatával nem telepített Windows Forms-alkalmazásokban az alkalmazás alkalmazásfájlja<>.exe.config az alkalmazáskönyvtárban, a user.config fájl pedig a felhasználó Dokumentumok és beállítások mappájában van tárolva. A ClickOnce-alkalmazásokban <az alkalmazás>.exe.config a ClickOnce alkalmazás gyorsítótárában található alkalmazáskönyvtárban ,user.config pedig az alkalmazás ClickOnce-adatkönyvtárában él.
Az alkalmazás üzembe helyezésétől függetlenül az Alkalmazásbeállítások biztonságos olvasási hozzáférést biztosítanak az <alkalmazás>.exe.config fájlhoz, valamint biztonságos olvasási/írási hozzáférést a user.config fájlhoz.
A ClickOnce-alkalmazásokban az alkalmazásbeállítások által használt konfigurációs fájlok méretét a ClickOnce-gyorsítótár mérete korlátozza. További információ: ClickOnce Cache – áttekintés.
.NET Core és .NET 5+
Jelenleg egy közzéteendő .NET Core-szerelvényt erős névkulcsfájllal kell aláírni. Ellenkező esetben, ApplicationSettingsBase.Upgrade eljárás nem másolja le helyesen a beállításokat egy új ClickOnce-közzététel után. A .NET Core-projekt tulajdonságai között az Erős név építése > opció alatt adhatja meg az erős név használatát.
Verziófrissítések
Ahogyan a ClickOnce-alkalmazások minden egyes verziója el van különítve az összes többi verziótól, a ClickOnce-alkalmazások alkalmazásbeállításai is el vannak különítve a többi verzió beállításaitól. Amikor a felhasználó az alkalmazás egy későbbi verziójára frissít, az alkalmazásbeállítások összehasonlítják a legújabb (legmagasabb számú) verzió beállításait a frissített verzióhoz megadott beállításokkal, és a beállításokat egy új beállításfájlba egyesíti.
Az alábbi táblázat azt ismerteti, hogy az alkalmazásbeállítások hogyan döntik el, hogy mely beállításokat másolja.
| A módosítás típusa | Frissítési művelet |
|---|---|
| Beállítás hozzáadva a <app>.exe.config-hez | Az új beállítás beolvad az aktuális verzió <app>.exe.config fájljába |
| Az <app>.exe.config fájlból eltávolított beállítás | A régi beállítás törlődik az aktuális verzió alkalmazásából<>.exe.config |
| A beállítás alapértelmezett értéke módosult; a helyi beállítás továbbra is az eredeti alapértelmezett értékre van állítva a user.config | Az aktuális verzió user.config fájljában a beállítás egyesítve lesz, az új alapértelmezettet állítva be értékként. |
| A beállítás alapértelmezett értéke módosult; beállítás nem alapértelmezett értékre van állítva a user.config | A beállítás az aktuális verzió user.config fájljába kerül egyesítésre, miközben megtartja a nem alapértelmezett értéket. |
Ha létrehozta saját alkalmazásbeállítások burkolóosztályát, és testre szeretné szabni a frissítési logikát, felülbírálhatja a metódust Upgrade .
A ClickOnce és a roaming beállításai
A ClickOnce nem működik az utazó beállításokkal, amelyek lehetővé teszik, hogy a beállításfájl kövesse Önt a hálózati gépeken. Ha barangolási beállításokra van szüksége, vagy olyan alkalmazásbeállítás-szolgáltatót kell implementálnia, amely a hálózaton tárolja a beállításokat, vagy egyéni beállításosztályokat kell kidolgoznia a beállítások távoli számítógépen való tárolásához. További információ a beállításszolgáltatókról: Alkalmazásbeállítások architektúrája.