この記事では、個々の ASP.NET アプリケーションの動作を制御するために使用する Web.config ファイルを作成する方法について説明します。
元の製品バージョン: ASP.NET
元の KB 番号: 815179
まとめ
Microsoft .NET Framework と特に ASP.NET は、XML 形式の .config ファイルを使用してアプリケーションを構成します。 この方法は、従来のレジストリとメタベース構成メカニズムから逸脱しています。 現在、Microsoft 管理コンソール (MMC) スナップインや、.config ファイルの作成と変更に使用できる Microsoft が提供するその他の管理ツールはありません。
.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>要素の先頭と末尾、および Web.config ファイルの<system.web>要素をマークします。 それ自体では、これらの行は何もしません。 ただし、行には、将来の構成設定を追加できる構造が用意されています。
<system.web>行と</system.web>行の間に、ASP.NET 構成設定の大部分を追加します。 これらの行は、ASP.NET 構成設定の先頭と末尾を示します。