Nastavení ClickOnce a aplikace
Nastavení aplikace v modelu Windows Forms usnadňuje vytváření, ukládání a udržování vlastní aplikace a uživatelských předvoleb na klientském počítači. Následující dokument popisuje, jak soubory nastavení aplikace pracují v aplikaci ClickOnce a jak ClickOnce přenese nastavení při uživatel aktualizuje na další verze.
Níže uvedené informace platí pouze pro poskytovatele výchozího nastavení aplikace třídy LocalFileSettingsProvider. Zadáváte-li vlastního poskytovatele, poskytovatel určí, jak ukládá její data a jak inovuje její nastavení mezi verzemi. Další informace o poskytovatelích nastavení aplikace naleznete v Application Settings Architecture.
Soubory nastavení aplikace
Nastavení aplikace používají dva soubory: app.exe.config a user.config, kde app je název aplikace Vašeho modelu Windows Forms. user.config je vytvořen v počítači klienta při prvním uložení uživatelských nastavení Vaší aplikace. app.exe.config, naopak bude existovat před nasazením, pokud jste definovali výchozí hodnoty nastavení. Visual Studio zahrne tento soubor automaticky při použití jeho příkazu Publish. Při vytváření aplikace ClickOnce pomocí Mage.exe nebo MageUI.exe je nutné ověřit, zda tento soubor je součástí ostatních souborů aplikace, když vyplňujete Váš manifest aplikace.
V aplikacích modelu Windows Forms, které nejsou zavedeny pomocí ClickOnce, je soubor app.exe.config uložen v adresáři aplikace, zatímco soubor user.config je uložen ve složce uživatele Documents and Settings. V aplikaci ClickOnce app.exe.config je umístěn v adresáři aplikace uvnitř mezipaměti aplikace ClickOnce a user.config je umístěn v adresáři dat ClickOnce pro danou aplikaci.
Bez ohledu na to, jak nasadíte svoji aplikaci, nastavení aplikace zajišťuje bezpečný přístup ke čtení z app.exe.config a bezpečný přístup pro čtení i zápis v user.config.
V aplikaci ClickOnce je velikost konfiguračních souborů používaných nastavením aplikace omezena velikostí mezipaměti ClickOnce. Další informace naleznete v tématu Přehled mezipaměti ClickOnce.
Aktualizace Verze
Stejně jako je každá verze aplikace ClickOnce izolována od všech ostatních verzí, jsou nastavení aplikace ClickOnce izolované od nastavení pro jiné verze aplikace. Když uživatel aktualizuje na novější verzi aplikace, nastavení aplikace porovná poslední (nejvýše očíslované) nastavení verze proti nastavení dodávanému s aktualizovanou verzí a sloučí nastavení do nové sady souborů nastavení.
Následující tabulka popisuje, jak nastavení aplikace rozhodne, které nastavení zkopírovat.
Typ změny |
Akce aktualizace |
|---|---|
Nastavení přidané do app.exe.config |
Nové nastavení je sloučeno do aktuální verze app.exe.config |
Nastavení odebráno z app.exe.config |
Staré nastavení je odebráno z aktuální verze app.exe.config |
Změněno výchozí nastavení; místní nastavení stále nastaveno na původní výchozí podle user.config |
Nastavení je sloučeno do aktuální verze user.config s novým výchozím jako hodnota |
Změněno výchozí nastavení; nastavení nastaveno na jiné než výchozí v user.config |
Nastavení je sloučeno do aktuální verze user.config se zachováním jiných než výchozích hodnot |
Pokud jste vytvořili vlastní obálkovou třídu nastavení aplikace a chcete přizpůsobit logiku aktualizace, můžete přepsat metodu Upgrade.
Nastavení ClickOnce a roaming
ClickOnce nepracuje s nastavením roaming umožňujícím souboru nastavení postupovat napříč počítači v síti. Potřebujete-li roaming nastavení, budete muset buď implementovat poskytovatele nastavení aplikace, který ukládá nastavení prostřednictvím sítě nebo vyvíjet vlastní třídy pro uložení nastavení na vzdáleném počítači. Další informace v nastavení poskytovatelů naleznete v tématu Application Settings Architecture.