Konfigurace aplikací pomocí konfiguračních souborů
Poznámka
Tento článek je specifický pro rozhraní .NET Framework. Nevztahuje se na novější implementace .NET, včetně .NET 6 a novějších verzí.
Rozhraní .NET Framework poskytuje vývojářům a správcům kontrolu a flexibilitu způsobu, jakým aplikace procházejí konfiguračními soubory . Konfigurační soubory jsou soubory XML, které je možné podle potřeby změnit. Správce může určit, ke kterým chráněným prostředkům může aplikace přistupovat, které verze sestavení bude aplikace používat a kde se nacházejí vzdálené aplikace a objekty. Vývojáři můžou nastavení umístit do konfiguračních souborů, což eliminuje nutnost překompilovat aplikaci při každé změně nastavení. Tato část popisuje, co se dá nakonfigurovat a proč může být konfigurace aplikace užitečná.
Poznámka
Spravovaný kód může použít třídy v oboru názvů System.Configuration ke čtení nastavení z konfiguračních souborů, ale ne k zápisu nastavení do těchto souborů.
Tento článek popisuje syntaxi konfiguračních souborů a poskytuje informace o třech typech konfiguračních souborů: počítač, aplikace a zabezpečení.
Formát konfiguračního souboru
Konfigurační soubory obsahují prvky, což jsou logické datové struktury, které nastavují informace o konfiguraci. V rámci konfiguračního souboru použijete značky k označení začátku a konce elementu. Například prvek <runtime>
se skládá z <runtime>
podřízených elementů</runtime>
. Prázdný prvek by byl zapsán jako <runtime/>
nebo <runtime></runtime>
.
Stejně jako u všech souborů XML je syntaxe v konfiguračních souborech citlivá na velká a malá písmena.
Nastavení konfigurace zadáte pomocí předdefinovaných atributů, které jsou páry name/value uvnitř počáteční značky elementu. Následující příklad určuje dva atributy (version
a href
) pro <codeBase>
element, který určuje, kde modul runtime může najít sestavení (další informace naleznete Určení umístění sestavení).
<codeBase version="2.0.0.0"
href="http://www.litwareinc.com/myAssembly.dll"/>
Konfigurační soubory počítače
Konfigurační soubor počítače Machine.configobsahuje nastavení, která platí pro celý počítač. Tento soubor se nachází v instalační cestě runtime %%\Config adresář. Machine.config obsahuje nastavení konfigurace pro vazbu sestavení na úrovni počítače, integrované kanály vzdálené komunikace a ASP.NET.
Konfigurační systém nejprve hledá v konfiguračním souboru počítače prvek <appSettings> element a další konfigurační oddíly, které může vývojář definovat. Pak se podívá do konfiguračního souboru aplikace. Chcete-li udržovat konfigurační soubor počítače spravovatelný, je nejlepší umístit tato nastavení do konfiguračního souboru aplikace. Umístěním nastavení do konfiguračního souboru počítače ale můžete systém lépe udržovat. Pokud máte například komponentu třetí strany, kterou používá klientská i serverová aplikace, je jednodušší umístit nastavení pro tuto komponentu na jednom místě. V tomto případě je konfigurační soubor počítače vhodným místem pro nastavení, takže nemáte stejná nastavení ve dvou různých souborech.
Poznámka
Nasazení aplikace pomocí XCOPY nebude kopírovat nastavení v konfiguračním souboru počítače.
Další informace o tom, jak modul CLR (Common Language Runtime) používá konfigurační soubor počítače pro vazbu sestavení, najdete v tématu Jak modul runtime vyhledá sestavení.
Konfigurační soubory aplikace
Konfigurační soubor aplikace obsahuje nastavení specifická pro aplikaci. Tento soubor obsahuje nastavení konfigurace, která běhové prostředí společného jazyka čte (například politika vazby sestavení, vzdálené objekty atd.) a nastavení, která může aplikace číst.
Název a umístění konfiguračního souboru aplikace závisí na hostiteli aplikace, což může být jedna z následujících možností:
Aplikace hostovaná ve spustitelném prostředí.
Tyto aplikace mají dva konfigurační soubory: zdrojový konfigurační soubor, který upravuje vývojář během vývoje, a výstupní soubor distribuovaný s aplikací.
Ve výchozím nastavení je název zdrojového konfiguračního souboru App.config. Při vytváření projektu rozhraní .NET Framework v sadě Visual Studio se do projektu automaticky přidá soubor App.config. Soubor můžete přidat také ručně tak, že vyberete Soubor>Nový soubor. Umístěte soubor App.config do adresáře projektu a nastavte jeho vlastnost Kopírovat do výstupního adresáře na Kopírovat vždy nebo Kopírovat, pokud novější.
Pokud chcete vytvořit výstupní konfigurační soubor, který je nasazený s aplikací, visual Studio zkopíruje zdrojový konfigurační soubor do adresáře, kde je kompilované sestavení umístěné. Tento soubor má název <název_aplikace>.exe.config. Například aplikace s názvem myApp.exe má výstupní konfigurační soubor s názvem myApp.exe.config.
V některých případech může Visual Studio upravit výstupní konfigurační soubor. Další informace najdete v tématu Verze přesměrování na úrovni aplikace.
ASP.NET hostovaná aplikace.
Další informace o konfiguračních souborech ASP.NET naleznete v tématu ASP.NET Nastavení konfigurace.
Konfigurační soubory zabezpečení
Konfigurační soubory zabezpečení obsahují informace o hierarchii skupiny kódu a sadách oprávnění přidružených k úrovni zásad. Důrazně doporučujeme použít nástroj Zásady zabezpečení přístupu kódu (Caspol.exe) ke změně zásad zabezpečení, aby se zajistilo, že změny zásad nebudou poškozeny konfigurační soubory zabezpečení.
Poznámka
Počínaje rozhraním .NET Framework 4 se konfigurační soubory zabezpečení nacházejí pouze v případě, že byly změněny zásady zabezpečení.
Konfigurační soubory zabezpečení jsou v následujících umístěních:
Konfigurační soubor zásad podniku: %cesta k instalaci za běhu%\Config\Enterprisesec.config
Konfigurační soubor zásad počítače: %%\Config\Security.config runtime-install-path
Konfigurační soubor zásad uživatele: %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx\Security.config