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

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

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

概要

Microsoft .NET Framework、特に ASP.NET では、XML 形式の.config ファイルを使用してアプリケーションを構成します。 この方法は、従来のレジストリおよびメタベース構成メカニズムからの逸脱です。 現在、Microsoft Management Console (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 ファイルには要素と<system.web>要素が<configuration>必要です。 これらの要素には、個々の構成要素が含まれます。

次の例は、最小限の 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 構成設定の先頭と末尾を示します。

関連情報