Sdílet prostřednictvím


Správa nastavení aplikace

Nastavení aplikace vám umožňují uložení informací aplikace dynamicky.Nastavení vám umožňují ukládat informace na klientský počítač, který by neměl být zařazen do kódu aplikace (například připojovací řetězec), uživatelských předvoleb a dalších informací, které potřebujete v době běhu.

Nastavení aplikace nahradí dynamické vlastnosti použité v dřívějších verzích sady Visual Studio.

Každé nastavení aplikace musí mít jedinečný název.Název může obsahovat libovolnou kombinaci písmen, čísel nebo podtržítek, která nezačíná číslem a neobsahuje mezery.Název lze změnit prostřednictvím vlastnosti Name.

Nastavení aplikace lze uložit jako libovolný typ dat, který lze serializovat v jazyce XML nebo který má TypeConverter, který implementuje ToString/FromString.Nejběžnější typy jsou String, Integer a Boolean, ale můžete také uložit hodnoty jako Color, Object nebo jako připojovací řetězec.

Nastavení aplikace také obsahují hodnotu.Hodnota je nastavena s vlastností Value a musí se shodovat s nastaveným typem dat.

Kromě toho nastavení aplikace mohou být vázány na vlastnost formuláře nebo ovládacího prvku v době návrhu.

Existují dva typy nastavení aplikace založené na rozsahu:

  • Nastavení oboru aplikace lze použít pro informace, jako je například adresa URL pro webovou službu nebo připojovací řetězec databáze.Tyto hodnoty jsou přidruženy k aplikaci.Proto je uživatelé nemohou změnit za běhu.

  • Nastavení s rozsahem uživatele lze použít pro informace, jako jsou například uchování poslední pozice formuláře nebo předvoleb písma.Uživatelé mohou změnit tyto hodnoty v době běhu.

Typ nastavení je možné změnit pomocí vlastnosti Rozsah.

Systém projektu ukládá nastavení aplikace ve dvou souborech XML: app.config soubor, který je vytvořen v době návrhu, když vytvoříte první nastavení aplikace; a user.config soubor, který je vytvořen v době běhu, když uživatel, který spouští aplikaci, změní hodnotu nastavení některého uživatele.Všimněte si, že změny v nastavení uživatele nejsou zapsány na disk, pokud aplikace konkrétně nevolá metodu, která by to provedla.

Vytvoření nastavení aplikace v době návrhu

V době návrhu, můžete vytvořit nastavení aplikace dvěma způsoby: pomocí Nastavení stránku Návrháře projektu, nebo pomocí Vlastnosti okna pro formulář nebo ovládací prvek, který umožňuje svázat nastavení vlastnosti.

Když vytvoříte nastavení s rozsahem aplikace (například připojovací řetězec databáze nebo odkaz na prostředky serveru), Visual Studio je uloží do app.config se značkou <applicationSettings>.(Připojovací řetězce jsou uloženy pod značkou <connectionStrings>.)

Když vytvoříte nastavení s rozsahem uživatele (například výchozí písmo, domovská stránka nebo velikost okna), Visual Studio je uloží do app.config se značkou <userSettings>.

Poznámka k zabezpečeníPoznámka k zabezpečení

Při ukládání připojovacích řetězců v app.config byste měli podniknout opatření k zamezení odhalení citlivých informací, jako jsou například hesla nebo cesty k serveru, v připojovacím řetězci.

Pokud získáte informaci o připojovacím řetězci z externího zdroje, například uživatelské zadání uživatelského ID a hesla, musíte být opatrní a zajistit, že hodnoty, které lze použít k sestavení připojovacího řetězce, neobsahují další parametry připojovacího řetězce, které mění chování vašeho připojení.

Zvažte použití funkce Protected Configuration pro šifrování citlivých informací v konfiguračním souboru.Podívejte se na téma Protecting Connection Information Další informace.

[!POZNÁMKA]

Protože neexistuje žádný model konfiguračního souboru pro knihovny tříd, nastavení aplikace nelze aplikovat na projekty knihovny tříd.Výjimka je projekt knihovny DLL Visual Studio Tools for Office, který může mít konfigurační soubor.

Použití vlastních souborů nastavení

Vlastní soubory nastavení můžete přidat do projektu pro pohodlné řízení skupin nastavení.Nastavení, která jsou obsažena v jediném souboru, jsou načtena a uložena jako celek.Proto možnost uložit nastavení do samostatných souborů pro často používané a zřídka používané skupiny může ušetřit čas při načítání a ukládání nastavení.

Například můžete přidat soubor jako je SpecialSettings.settings do vašeho projektu.Zatímco vaše třída SpecialSettings není vystavena v oboru názvů My, Zobrazit kód může přečíst soubor s vlastním nastavením obsahující Partial Class SpecialSettings.

Návrhář nastavení nejprve hledá soubor Settings.settings, který vytvoří systém projektu; toto je výchozí soubor, který Návrhář projektu zobrazí v kartě Nastavení.Settings.settings je umístěn ve složce Můj projekt pro projekty Visual Basic a ve složce Vlastnosti pro projekty Visual C#.Návrhář projektu pak vyhledá ostatní soubory nastavení v kořenové složce projektu.Proto byste zde měli umístit soubor s vlastním nastavením.Přidáte-li soubor .settings jinde v projektu, Návrhář projektu nebude schopen jej vyhledat.

Přístup nebo změna nastavení aplikace za běhu v jazyce Visual Basic

V projektech Visual Basic můžete získat přístup k nastavení aplikace za běhu pomocí objektu My.Settings.Na stránce Nastavení klikněte na tlačítko Zobrazit kód k zobrazení souboru Settings.vb.Settings.vb definuje třídu Settings, která umožňuje zpracování těchto událostí na třídě nastavení: SettingChanging, PropertyChanged, SettingsLoaded a SettingsSaving.Všimněte si, že třída Settings v Settings.vb je částečná třída zobrazující pouze uživatelský kód, nikoli celou generovanou třídu.Další informace o přístupu k nastavení aplikace s použitím My.Settings objektu naleznete v tématu Přístup k nastavení aplikace (Visual Basic).

Hodnoty všech nastavení rozsahu uživatele, která uživatel změní za běhu (například umístění formuláře), jsou uloženy v souboru user.config.Všimněte si, že výchozí hodnoty jsou stále uloženy v app.config.

Pokud jste změnili nastavení rozsahu uživatele za běhu, například v aplikaci, testování a chcete resetovat tato nastavení na výchozí hodnoty, klepněte Synchronizovat tlačítko.

Důrazně doporučujeme používat objekt My.Settings a výchozí soubor .settings k přístupu k nastavení.Důvodem je, že můžete použít Návrháře nastavení k přiřazení vlastností do nastavení, a navíc, uživatelské nastavení je automaticky uloženo před vypnutím aplikace.Avšak vaše aplikace Visual Basic může získat přístup k nastavení přímo.V takovém případě budete muset získat přístup ke třídě MySettings a použít vlastní soubor .settings v kořenové složce projektu.Musíte také uložit nastavení uživatele před ukončením aplikace, jako byste to udělali pro aplikaci v jazyce C#; to je popsáno v následujícím oddíle.

Přístup nebo změna nastavení aplikace za běhu v jazyce Visual C#

V jazycích jiných než Visual Basic, jako jsou například Visual C#, je nutné získat přístup ke třídě Settings přímo, jak je znázorněno v následujícím příkladě Visual C#.

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

Musíte také explicitně volat metodu Save této obálkové třídy s cílem zachovat nastavení uživatele.To lze obvykle provést v obslužné rutině události Closing hlavního formuláře.Následující příklad Visual C# ukazuje volání metody Save.

Properties.Settings.Default.Save();

Konkrétní příklad, jak vytvořit nové nastavení aplikace a svázat ho s vlastnostmi ve formuláři, naleznete v části Postupy: Vytváření nastavení aplikace pomocí Návrháře.Další obecné informace o přístupu k nastavení aplikace prostřednictvím Settings třídy naleznete v tématu Přehled nastavení aplikace.Informace o iterace nastavení naleznete v tématu to příspěvek ve fóru.

Viz také

Koncepty

Přístup k nastavení aplikace (Visual Basic)