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

  • [アーティクル]

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

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

概要

Web.config ファイルは、ASP.NET アプリケーションの動作を定義します。 Microsoft .NET Frameworkは、ASP.NET を含め、XML 形式の .config テキスト ファイルを使用してアプリケーションを構成します。 これは、従来のレジストリとメタベースの構成メカニズムとは異なっています。 現在、Microsoft 管理コンソール (MMC) スナップインや、.config ファイルを作成および変更するための 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 ファイルでオーバーライドする構成設定を見つけます。 要素が複数の行である場合、要素は 1 行で <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> ) の末尾は、構成要素の後に配置する必要があります。

    注:

    構成要素が含まれている要素。 その要素は、 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 ファイルとすべてのサブ フォルダーを含むフォルダーに適用されます。

関連情報