Tworzenie pliku Web.config dla aplikacji ASP.NET

W tym artykule opisano sposób tworzenia pliku Web.config używanego do kontrolowania zachowania poszczególnych aplikacji ASP.NET.

Oryginalna wersja produktu: ASP.NET
Oryginalny numer KB: 815179

Podsumowanie

Firma Microsoft .NET Framework, a w szczególności ASP.NET, używa plików .config w formacie XML do konfigurowania aplikacji. Ta praktyka jest odejściem od konwencjonalnych mechanizmów konfiguracji rejestru i metabazy. Obecnie nie ma przystawki programu Microsoft Management Console (MMC) ani innego narzędzia administracyjnego dostarczonego przez firmę Microsoft, którego można użyć do tworzenia i modyfikowania plików .config.

Hierarchia plików .config

.NET Framework korzysta z .config plików, aby zdefiniować opcje konfiguracji. Pliki .config są plikami XML opartymi na tekście. Wiele .config plików może i zazwyczaj istnieje w jednym systemie.

Ustawienia konfiguracji dla całego systemu dla .NET Framework są definiowane w pliku Machine.config. Plik Machine.config znajduje się w folderze %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ . Ustawienia domyślne zawarte w pliku Machine.config można zmodyfikować w celu wpływania na zachowanie aplikacji microsoft .NET w całym systemie.

Ustawienia konfiguracji ASP.NET dla pojedynczej aplikacji można zmienić, jeśli utworzysz plik Web.config w folderze głównym aplikacji. W takim przypadku ustawienia w pliku Web.config zastępują ustawienia w pliku Machine.config .

Tworzenie pliku Web.config

Plik Web.config można utworzyć za pomocą edytora tekstów, takiego jak Notatnik. Musisz utworzyć plik tekstowy o nazwie Web.config w katalogu głównym aplikacji ASP.NET. Plik Web.config musi być dobrze sformułowanym dokumentem XML i musi mieć format podobny do %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config pliku.

Plik Web.config musi zawierać tylko wpisy dla elementów konfiguracji, które zastępują ustawienia w pliku Machine.config . Co najmniej plik Web.config musi mieć <configuration> element i <system.web> element. Te elementy będą zawierać poszczególne elementy konfiguracji.

W poniższym przykładzie przedstawiono minimalny plik Web.config :

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
    </system.web>
</configuration>

Pierwszy wiersz pliku Web.config opisuje dokument jako sformatowany w formacie XML i określa typ kodowania znaków. Ten pierwszy wiersz musi być taki sam dla wszystkich plików .config.

Wiersze, które następują, oznaczają początek i koniec <configuration> elementu oraz <system.web> element pliku Web.config . Same w sobie te linie nic nie robią. Jednak linie zapewniają strukturę, która umożliwia dodawanie ustawień konfiguracji w przyszłości. Większość ustawień konfiguracji ASP.NET między wierszami <system.web> i </system.web> . Te wiersze oznaczają początek i koniec ustawień konfiguracji ASP.NET.

Informacje