ASP.NET アプリケーションの Web.config ファイルを作成する

  • [アーティクル]

この記事では、個々の ASP.NET アプリケーションの動作を制御するために使用するWeb.configファイルを作成する方法について説明します。

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

概要

Microsoft .NET Frameworkと ASP.NET は、特に XML 形式の .config ファイルを使用してアプリケーションを構成します。 この方法は、従来のレジストリとメタベースの構成メカニズムから逸脱しています。 現在、Microsoft 管理コンソール (MMC) スナップインやその他の Microsoft 提供の管理ツールはありません。このツールを使用して、.config ファイルの作成と変更を行うことができます。

.config ファイルの階層

.NET Frameworkは、.config ファイルに依存して構成オプションを定義します。 .config ファイルはテキスト ベースの XML ファイルです。 複数の .config ファイルを 1 つのシステム上に存在させることができます。通常は存在します。

.NET Frameworkのシステム全体の構成設定は、Machine.config ファイルで定義されます。 Machine.config ファイルはフォルダーにあります%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\。 Machine.config ファイルに含まれる既定の設定は、システム全体での Microsoft .NET アプリケーションの動作に影響するように変更できます。

アプリケーションのルート フォルダーにWeb.configファイルを作成する場合は、1 つのアプリケーションの ASP.NET 構成設定を変更できます。 これを行うと、 Web.config ファイルの設定が 、Machine.config ファイルの設定よりも優先されます。

Web.config ファイルを作成する

メモ帳などのテキスト エディターを使用して、 Web.config ファイルを作成できます。 ASP.NET アプリケーションのルート ディレクトリ にWeb.config という名前のテキスト ファイルを作成する必要があります。 Web.config ファイルは、整形式の XML ドキュメントである必要があり、ファイルと同様の形式である%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config必要があります。

Web.configファイルには、 Machine.config ファイルの 設定をオーバーライドする構成項目のエントリのみを含める必要があります。 少なくとも、Web.config ファイルには 要素と 要素が<configuration><system.web>必要です。 これらの要素には、個々の構成要素が含まれます。

次の例は、最小限の Web.configファイルを 示しています。

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

Web.config ファイルの最初の行は、ドキュメントを XML 形式として記述し、文字エンコードの種類を指定します。 この最初の行は、すべての .config ファイルで同じである必要があります。

次の行は、要素の <configuration> 先頭と末尾、および <system.web>Web.config ファイルの要素をマークします。 それ自体では、これらの行は何もしません。 ただし、行には、将来の構成設定を追加できる構造が用意されています。 と 行の間に ASP.NET 構成設定の大部分を<system.web></system.web>追加します。 これらの行は、ASP.NET 構成設定の先頭と末尾を示します。

関連情報