次の方法で共有


pages の controls 要素 (ASP.NET 設定スキーマ)

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

レジスタ ディレクティブのコレクションおよびタグ プレフィックスが存在する名前空間を定義します。

この要素は、.NET Framework Version 2.0 で追加されました。

<controls> 
   <add /> 
</controls>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

なし。

子要素

要素

Description

add

省略可能な要素です。

プリコンパイル時に使用されるタグ プレフィックスのコレクションに、タグ プレフィックスを追加します。

親要素

要素

Description

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。

system.web

構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。

pages

構成ファイルのスコープ内にあるページおよびコントロールの ASP.NET のディレクティブなど、ページ固有の構成設定をグローバルに定義します。

解説

controls 要素は、レジスタ ディレクティブのコレクションおよびタグ プレフィックスが存在する名前空間を定義します。 この要素は、ASP.NET ページの @ Register ディレクティブに対応しています。 @ Register ディレクティブを使用すると、ユーザー コントロールのタグ プレフィックスを指定できます。

タグ プレフィックスは、COM コントロールやユーザー コントロールが正しく動作するために含める必要があるアセンブリと名前空間に ASP.NET の名前空間を関連付けます。 次の情報は、controls 要素を構成する際に役立ちます。

  • ユーザー コントロールに適用する場合は、add 子要素の tagPrefix、tagName、および source の各属性を定義する必要があります。

  • カスタム コントロールに適用する場合は、add 子要素の tagPrefix、namespace、および assembly の各属性を定義する必要があります。 assembly 属性は、コントロールがアプリケーション コード ディレクトリの中にある場合は必要ありません。

同じ tagPrefix 値を使用して、複数のアセンブリまたは名前空間に対応付けることができます。

既定の構成

次の既定の controls 要素は、ルートの Web.config ファイルで構成されます。

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

使用例

controls 要素の複数の属性に対して宣言により値を指定する方法を次のコード例に示します。またこれらは、TagPrefixInfo クラスのメンバーとしてプログラムにより指定することもできます。

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagPrefix="MyTags3" 
            tagName="MyCtrl" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

要素情報

構成セクション ハンドラー

PagesSection

構成メンバー

Controls

TagPrefixCollection

構成できる場所

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

pages 要素 (ASP.NET 設定スキーマ)

pages の controls の add 要素 (ASP.NET 設定スキーマ)

pages の tagMapping 要素 (ASP.NET 設定スキーマ)

pages の namespaces 要素 (ASP.NET 設定スキーマ)

system.web 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

概念

ASP.NET Configuration File Hierarchy

Securing Configuration

その他の技術情報

全般構成設定 (ASP.NET)

ASP.NET 構成設定

Configuring ASP.NET Applications

ASP.NET Configuration API