compilation の buildProviders の add 要素 (ASP.NET 設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
コレクションにビルド プロバイダーを追加します。
この要素は、.NET Framework Version 2.0 で追加されました。
<add
extension="custom resource file extension"
type="build provider type, build provider assembly" />
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
extension |
必須の String 属性です。 カスタム リソース ファイルの拡張子を定義します。 この属性はコレクション キーです。 既定値は、空の文字列 ("") です。 |
type |
必須の String 属性です。 extension 属性で指定されたファイルのコンパイルに使用する型とアセンブリを定義します。 既定値は、空の文字列 ("") です。 |
子要素
なし。
親要素
要素 |
Description |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。 |
system.web |
ASP.NET 構成セクションのルート要素を指定します。 |
compilation |
ASP.NET でアプリケーションのコンパイルに使用されるすべてのコンパイル設定値を構成します。 |
buildProviders |
カスタム リソース ファイルをコンパイルするために使用されるビルド プロバイダーのコレクションを定義します。 |
解説
add 要素は、buildProviders 要素に含まれるコレクションにビルド プロバイダーを追加します。
buildProviders 要素は、コンパイル時に、特定のファイルの種類のカスタム リソース ファイルをコンパイルしてコードを生成するために使用されるビルド プロバイダーのコレクションを定義します。
ASP.NET アプリケーション内のファイルの種類に対するカスタム ビルド アクションを定義するには、BuildProvider からクラスを派生させ、ファイルの種類をビルドするための派生クラス内にメンバーを実装し、アプリケーション構成ファイル内で対応する拡張子のビルド プロバイダーを構成します。 詳細については、「BuildProvider」を参照してください。
既定の構成
次に示す既定の buildProviders 要素は、ルート Web.config ファイル内で構成されます。
<buildProviders>
<add extension=".aspx" type="System.Web.Compilation.PageBuildProvider" />
<add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider" />
<add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider" />
<add extension=".asix" type="System.Web.Compilation.ImageGeneratorBuildProvider" />
<add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider" />
<add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider" />
<add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider" />
<add extension=".resx" type="System.Web.Compilation.ResXBuildProvider" />
<add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider" />
<add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider" />
<add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"/>
<add extension=".js" type="System.Web.Compilation.ForceCopyBuildProvider" />
</buildProviders>
使用例
指定した拡張子を持つカスタム リソース ファイルのコンパイルに使用されるビルド プロバイダーを定義する方法を次のコード例に示します。
<configuration>
<system.web>
<compilation>
<buildProviders>
<add
extension=".mafx"
type="MyBuildProviderType, MyBuildProviderAssembly"/>
</buildProviders>
</compilation>
</system.web>
</configuration>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config 仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config |
要件 |
Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 .NET Framework Version 2.0 Microsoft Visual Studio 2003 または Visual Studio 2005 |
参照
処理手順
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Reference
compilation の buildProviders 要素 (ASP.NET 設定スキーマ)
compilation の buildProviders の clear 要素 (ASP.NET 設定スキーマ)
compilation の assemblies の remove 要素 (ASP.NET 設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
compilation 要素 (ASP.NET 設定スキーマ)
概念
ASP.NET Configuration File Hierarchy
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios