Udostępnij za pośrednictwem

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

Program Microsoft .NET Framework i ASP.NET w szczególności używa plików konfiguracji w formacie XML do konfigurowania aplikacji. Jest to odejście 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

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

Ustawienia konfiguracji dla platformy .NET Framework dla całego systemu 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ć, aby wpływać na zachowanie aplikacji microsoft .NET w całym systemie.

Ustawienia konfiguracji ASP.NET dla pojedynczej aplikacji można zmienić, jeśli tworzysz 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ć przy użyciu 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 zawierać <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 format XML i określa typ kodowania znaków. Ten pierwszy wiersz musi być taki sam dla wszystkich plików config.

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

Informacje