TagMapCollection クラス

.NET Framework クラス ライブラリ リファレンス

TagMapCollection クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

TagMapInfo オブジェクトのコレクションを格納します。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 TagMapCollection
    Inherits ConfigurationElementCollection

Visual Basic (使用法)

Dim instance As TagMapCollection

C#

public sealed class TagMapCollection : ConfigurationElementCollection

C++

public ref class TagMapCollection sealed :
 public ConfigurationElementCollection

J#

public final class TagMapCollection extends
 ConfigurationElementCollection

JScript

public final class TagMapCollection extends
 ConfigurationElementCollection

解説

TagMapInfo クラスを使用すると、タグの型をコンパイル時にリマップできます。このリマップにより、構成ファイルのスコープ内の、ASP.NET アプリケーションのすべてのページとコントロールで、元のタグの型の代わりにマップされた型が使用されます。

TagMapCollection クラスを使用すると、構成ファイル内の pages セクションの tagMapping サブセクションにプログラムからアクセスして変更できます。tagMapping サブセクションで、型の厳密な完全修飾名を指定することにより、タグの型どうしのマッピングを追加および削除できます。

メモ
pages セクションのその他の属性やコレクションとは異なり、タグのマッピングには対応する ASP.NET ページ ディレクティブはありません。

使用例

以下は構成ファイルからの抜粋です。TagMapCollection 型の複数のプロパティに対して、宣言によって値を指定する方法を示しています。

<system.web>
  <pages>
    <tagMapping>
      <clear />
      <add
        tagType=
          "System.Web.UI.WebControls.WebParts.WebPartManager"
        mappedTagType=
          "Microsoft.Sharepoint.WebPartPartManager, 
           MSPS.Web.dll, Version='2.0.0.0'" 
      />
      <remove tagType="SomeOtherNS.Class, Assemblyname" />
    </tagMapping>
   </pages>
</system.web>

TagMapCollection クラスを使用して、プログラムからタグ マッピング設定を変更する方法を次のコード例に示します。このコード例は、PagesSection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Get all current TagMappings in the collection.
Dim k As Int32
For k = 1 To pagesSection.TagMapping.Count
  Console.WriteLine("TagMapping {0}:", i)
  Console.WriteLine("  TagTypeName = '{0}'", _
   pagesSection.TagMapping(k).TagType)
  Console.WriteLine("  MappedTagTypeName = '{0}'", _
   pagesSection.TagMapping(k).MappedTagType)
Next

' Add a TagMapInfo object using a constructor.
pagesSection.TagMapping.Add( _
 New System.Web.Configuration.TagMapInfo( _
 "MyNameSpace.MyControl", "MyNameSpace.MyOtherControl"))

C#

// Get all current TagMappings in the collection.
for (int i = 0; i < pagesSection.TagMapping.Count;
 i++)
{
  Console.WriteLine("TagMapping {0}:", i);
  Console.WriteLine("  TagTypeName = '{0}'",
      pagesSection.TagMapping[i].TagType);
  Console.WriteLine("  MappedTagTypeName = '{0}'",
      pagesSection.TagMapping[i].MappedTagType);
}

// Add a TagMapInfo object using a constructor.
pagesSection.TagMapping.Add(
    new System.Web.Configuration.TagMapInfo(
    "MyNameSpace.MyControl", "MyNameSpace.MyOtherControl"));

継承階層

System.Object
   System.Configuration.ConfigurationElement
     System.Configuration.ConfigurationElementCollection
      System.Web.Configuration.TagMapCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TagMapCollection メンバ
System.Web.Configuration 名前空間
PagesSection クラス
TagMapInfo
その他の技術情報
pages 要素 (ASP.NET 設定スキーマ)
pages の tagMapping 要素 (ASP.NET 設定スキーマ)