Edytowanie konfiguracji aplikacji ASP.NET

  • Artykuł

W tym artykule opisano sposób edytowania pliku Web.config aplikacji ASP.NET.

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

Podsumowanie

Plik Web.config definiuje zachowanie aplikacji ASP.NET. Usługa Microsoft .NET Framework, w tym ASP.NET, używa plików tekstowych w formacie XML .config 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 do tworzenia i modyfikowania plików .config.

Dodawanie ustawień konfiguracji do Web.config

Większość ASP.NET aplikacji zawiera wstępnie utworzony plik Web.config , który można edytować za pomocą dowolnego edytora tekstów, takiego jak Notatnik. Ogólnie rzecz biorąc, Web.config pliki zawierają komentarze, które sprawiają, że edytowanie pliku jest objaśniające. Jednak może być konieczne dodanie elementów konfiguracji do pliku Web.config , który nie ma jeszcze zdefiniowanego elementu konfiguracji. Aby dodać standardowy element konfiguracji do pliku Web.config , wykonaj następujące kroki:

  1. Otwórz plik Machine.config w edytorze tekstów, takim jak Notatnik.

    Plik Machine.config znajduje się w %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ katalogu.

  2. W pliku Machine.config znajdź ustawienie konfiguracji, które chcesz zastąpić w pliku Web.config . Gdy element jest więcej niż jednym wierszem, element rozpoczyna się od wiersza <element_name> i kończy się ciągiem </element_name>. Element może również być zamykany samodzielnie i może wyglądać podobnie do <element_name attribute1='option' attribute2='option' />elementu . Białe znaki są ignorowane. W związku z tym element może obejmować wiele wierszy. Element może być poprzedzony komentarzem. Komentarz znajduje się wewnątrz <!-- and --> oznaczeń. Poniższy <trace> przykład elementu konfiguracji jest przykładem elementu samozamykania. Przykład <trace> elementu konfiguracji ma wiele atrybutów, obejmuje wiele wierszy i ma komentarz na początku.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. Skopiuj cały element konfiguracji i dowolny komentarz początkowy do schowka.

  4. Określ sposób zagnieżdżenia elementu w pliku Machine.config .

    Plik Machine.config jest hierarchiczny, a elementy konfiguracji są zagnieżdżone w innych elementach. Podczas kopiowania elementu konfiguracji z pliku Machine.config do pliku Web.config należy zagnieżdżać ten element konfiguracji w tym samym elemencie, z który został skopiowany. Aby określić element pliku Machine.config , w który znajduje się element konfiguracji, przewiń w górę w pliku Machine.config , aż znajdziesz element, który jest otwarty, a nie zamknięty. Element zawierający jest prosty do zidentyfikowania, ponieważ elementy wyższego poziomu mają mniejsze wcięcia.

    Większość ASP.NET elementów konfiguracji znajduje się w elemencie <system.web> . Koniec elementu ( </system.web> ) należy umieścić po elemencie konfiguracji.

    Uwaga

    Element zawarty w elemencie konfiguracji. Należy wkleić ten element w tym samym elemencie w pliku Web.config . Element konfiguracji może być zagnieżdżony w wielu elementach. Wszystkie elementy wyższego poziomu należy utworzyć w pliku Web.config .

  5. Zamknij plik Machine.config , a następnie otwórz plik Web.config w katalogu głównym aplikacji ASP.NET za pomocą edytora tekstów.

  6. Wklej element konfiguracji między początkiem a końcem elementu zidentyfikowanego w kroku 4.

    Jeśli na przykład element konfiguracji znajduje się w elemencie, element konfiguracji musi zostać wklejony <system.web> bezpośrednio po wierszu <system.web> otwarcia elementu i przed linią zamykającą </system.web> .

  7. Zmodyfikuj element konfiguracji w pliku Web.config , aby zastąpić ustawienie Machine.config dla tej aplikacji.

    To ustawienie dotyczy folderu zawierającego plik Web.config i wszystkie foldery podrzędne.

Informacje