次の方法で共有

ASP.NET アプリケーションの構成を編集する

この記事では、ASP.NET アプリケーションの Web.config ファイルを編集する方法について説明します。

元の製品バージョン: ASP.NET
元の KB 番号: 815178

まとめ

Web.config ファイルは、ASP.NET アプリケーションの動作を定義します。 ASP.NET を含む Microsoft .NET Framework では、XML 形式の .config テキスト ファイルを使用してアプリケーションを構成します。 これは、従来のレジストリとメタベース構成メカニズムからの逸脱です。 現在、.config ファイルを作成および変更するための Microsoft 管理コンソール (MMC) スナップインやその他の Microsoft が提供する管理ツールはありません。

Web.config に構成設定を追加する

ほとんどの ASP.NET アプリケーションには、メモ帳などの任意のテキスト エディターで編集できる事前構築済みの Web.config ファイルが付属しています。 一般に、 Web.config ファイルには、ファイルの編集を説明するコメントが含まれています。 ただし、構成項目がまだ定義されていない Web.config ファイルに構成項目を追加しなければならない場合があります。 標準構成項目を Web.config ファイルに追加するには、次の手順に従います。

  1. メモ帳などのテキスト エディターで Machine.config ファイルを開きます。

    Machine.config ファイルは、%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ ディレクトリにあります。

  2. Machine.config ファイルで、オーバーライドする構成設定を Web.config ファイルで見つけます。 要素が複数の行である場合、要素は <element_name> 行で始まり、 </element_name>で終わります。 要素は自己終了でもあり、 <element_name attribute1='option' attribute2='option' />のようになります。 空白は無視されます。 したがって、要素は複数の行にまたがる場合があります。 要素の前にコメントを付ける場合があります。 コメントは、 <!-- and --> マーキング内に含まれています。 次の <trace> 構成要素の例は、自己終了要素の例です。 <trace>構成要素の例には、複数の属性があり、複数の行にまたがるものがあり、先頭にコメントがあります。

    <!--
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. 構成要素全体と開始コメントをクリップボードにコピーします。

  4. Machine.config ファイル内での要素の入れ子の方法を決定します。

    Machine.config ファイルは階層構造であり、構成要素は他の要素に入れ子になっています。 Machine.config ファイルから Web.config ファイルに構成要素をコピーする場合は、その構成要素をコピー元と同じ要素に入れ子にする必要があります。 構成要素が含まれている Machine.config ファイルの要素を特定するには、 Machine.config ファイル内で、開いている要素が見つかるまで上にスクロールし、閉じていません。 上位レベルの要素のインデントが少ないため、包含要素は簡単に識別できます。

    ほとんどの ASP.NET 構成項目は、 <system.web> 要素に含まれています。 要素 ( </system.web> ) の末尾は、構成要素の後に配置する必要があります。

    Note

    構成要素が含まれている要素。 その要素は、 Web.config ファイル内の同じ要素に貼り付ける必要があります。 構成要素は、複数の要素に入れ子にすることができます。 Web.config ファイルにすべての上位レベルの要素を作成する必要があります。

  5. Machine.config ファイルを閉じ、テキスト エディターを使用して、ASP.NET アプリケーションのルート ディレクトリにある Web.config ファイルを開きます。

  6. 手順 4 で識別した要素の先頭と末尾の間に構成要素を貼り付けます。

    たとえば、構成項目が <system.web> 要素に含まれている場合、構成項目は、 <system.web> 要素の開始行の直後と </system.web> 終了行の前に貼り付ける必要があります。

  7. Web.config ファイルの構成要素を変更して、そのアプリケーションの Machine.config 設定をオーバーライドします。

    この設定は、 Web.config ファイルとすべてのサブ フォルダーを含むフォルダーに適用されます。

関連情報