Udostępnij za pośrednictwem


Konfigurowanie aplikacji przy użyciu plików konfiguracji

Notatka

Ten artykuł jest specyficzny dla programu .NET Framework. Nie ma zastosowania do nowszych implementacji platformy .NET, w tym .NET 6 i nowszych wersji.

Program .NET Framework zapewnia deweloperom i administratorom kontrolę i elastyczność w sposobie uruchamiania aplikacji za pośrednictwem plików konfiguracji . Pliki konfiguracji to pliki XML, które można zmienić w razie potrzeby. Administrator może kontrolować, do których chronionych zasobów aplikacja ma dostęp, które wersje zestawów będzie używać aplikacja, oraz gdzie znajdują się zdalne aplikacje i obiekty. Deweloperzy mogą umieszczać ustawienia w plikach konfiguracji, eliminując konieczność ponownego kompilowania aplikacji za każdym razem, gdy zmienia się ustawienie. W tej sekcji opisano, co można skonfigurować i dlaczego konfigurowanie aplikacji może być przydatne.

Notatka

Kod zarządzany może używać klas w przestrzeni nazw System.Configuration do odczytywania ustawień z plików konfiguracji, ale nie do zapisywania ustawień w tych plikach.

W tym artykule opisano składnię plików konfiguracji i przedstawiono informacje o trzech typach plików konfiguracji: maszynie, aplikacji i zabezpieczeniach.

Format pliku konfiguracji

Pliki konfiguracji zawierają elementy, które są logicznymi strukturami danych, które ustawiają informacje o konfiguracji. W pliku konfiguracji używasz tagów, aby oznaczyć początek i koniec elementu. Na przykład element <runtime> składa się z elementów podrzędnych <runtime></runtime>. Pusty element zostanie zapisany jako <runtime/> lub <runtime></runtime>.

Podobnie jak w przypadku wszystkich plików XML, składnia w plikach konfiguracji jest czuła na wielkość liter.

Ustawienia konfiguracji określa się przy użyciu wstępnie zdefiniowanych atrybutów, które są parami nazwa/wartość wewnątrz tagu startowego elementu. Poniższy przykład określa dwa atrybuty (version i href) dla elementu <codeBase>, który określa, gdzie środowisko uruchomieniowe może zlokalizować zestaw (aby uzyskać więcej informacji, zobacz Określanie lokalizacji zestawu).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

Pliki konfiguracji maszyny

Plik konfiguracji maszyny, Machine.config, zawiera ustawienia, które mają zastosowanie do całego komputera. Ten plik znajduje się w ścieżce instalacji środowiska uruchomieniowego %%katalogu \Config. Machine.config zawiera ustawienia konfiguracji powiązań zestawu obejmującego całą maszynę, wbudowane kanały komunikacji wirtualnej i ASP.NET.

System konfiguracji najpierw wyszukuje w pliku konfiguracji maszyny element <appSettings> i inne sekcje konfiguracji, które programista może zdefiniować. Następnie zostanie on wyświetlony w pliku konfiguracji aplikacji. Aby zachować możliwość zarządzania plikiem konfiguracji maszyny, najlepiej umieścić te ustawienia w pliku konfiguracji aplikacji. Jednak umieszczenie ustawień w pliku konfiguracji maszyny może sprawić, że system będzie bardziej konserwowalny. Jeśli na przykład masz składnik innej firmy używany zarówno przez klienta, jak i aplikację serwera, łatwiej jest umieścić ustawienia dla tego składnika w jednym miejscu. W takim przypadku plik konfiguracji maszyny jest odpowiednim miejscem dla ustawień, więc nie masz tych samych ustawień w dwóch różnych plikach.

Notatka

Wdrożenie aplikacji przy użyciu narzędzia XCOPY nie spowoduje skopiowania ustawień w pliku konfiguracji maszyny.

Aby uzyskać więcej informacji na temat sposobu, w jaki środowisko uruchomieniowe języka wspólnego używa pliku konfiguracji maszyny do powiązania zestawów, zobacz Jak środowisko uruchomieniowe lokalizuje zestawy.

Pliki konfiguracji aplikacji

Plik konfiguracji aplikacji zawiera ustawienia specyficzne dla aplikacji. Ten plik zawiera ustawienia konfiguracji odczytywane przez środowisko uruchomieniowe języka wspólnego (CLR) (takie jak zasady powiązań zestawów, obiekty zdalne itd.) oraz ustawienia, które aplikacja może odczytać.

Nazwa i lokalizacja pliku konfiguracji aplikacji zależą od hosta aplikacji, który może być jednym z następujących elementów:

  • Aplikacja hostowana przez plik wykonywalny.

    Te aplikacje mają dwa pliki konfiguracji: źródłowy plik konfiguracji, który jest modyfikowany przez dewelopera podczas programowania, oraz plik wyjściowy, który jest dystrybuowany z aplikacją.

    Domyślnie nazwa pliku konfiguracji źródłowej to App.config. Podczas tworzenia projektu .NET Framework w programie Visual Studio plik App.config jest automatycznie dodawany do projektu. Możesz również ręcznie dodać plik, wybierając pozycję Plik>Nowy plik. Umieść plik App.config w katalogu projektu i ustaw jego właściwość Copy To Output Directory na wartość Kopiuj zawsze lub Kopiuj, jeśli nowszy.

    Aby utworzyć plik konfiguracji danych wyjściowych wdrożony za pomocą aplikacji, program Visual Studio kopiuje plik konfiguracji źródłowej do katalogu, w którym znajduje się skompilowany zestaw. Ten plik ma nazwę <nazwa_aplikacji>.exe.config. Na przykład aplikacja o nazwie myApp.exe ma plik konfiguracji wyjściowej o nazwie myApp.exe.config.

    W niektórych przypadkach program Visual Studio może zmodyfikować plik konfiguracji danych wyjściowych. Aby uzyskać więcej informacji, zobacz Wersje przekierowań na poziomie aplikacji.

  • ASP.NET – aplikacja hostowana.

    Aby uzyskać więcej informacji na temat plików konfiguracji ASP.NET, zobacz ASP.NET Configuration Settings.

Pliki konfiguracji zabezpieczeń

Pliki konfiguracji zabezpieczeń zawierają informacje o hierarchii grup kodu i zestawach uprawnień skojarzonych z poziomem zasad. Zdecydowanie zalecamy użycie narzędzia Code Access Security Policy (Caspol.exe) w celu zmodyfikowania zasad zabezpieczeń w celu zapewnienia, że zmiany zasad nie uszkodzą plików konfiguracji zabezpieczeń.

Notatka

Począwszy od programu .NET Framework 4, pliki konfiguracji zabezpieczeń są obecne tylko wtedy, gdy zasady zabezpieczeń zostały zmienione.

Pliki konfiguracji zabezpieczeń znajdują się w następujących lokalizacjach:

  • Plik konfiguracji zasad przedsiębiorstwa: %runtime-install-path%\Config\Enterprisesec.config

  • Plik konfiguracji zasad maszyny: %ścieżka-instalacji środowiska uruchomieniowego%\Config\Security.config

  • Plik konfiguracji zasad użytkownika: %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx\Security.config

Zobacz też