TagMapInfo クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

TagMapInfo クラス

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

構成タグリマップステートメントを 1 つ格納します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 TagMapInfo
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As TagMapInfo

public sealed class TagMapInfo : ConfigurationElement

C++

public ref class TagMapInfo sealed : public
 ConfigurationElement

public final class TagMapInfo extends ConfigurationElement

JScript

public final class TagMapInfo extends
 ConfigurationElement

解説

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

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

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

使用例

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

<system.web>
  <pages>
    <tagMapping>
      <add
        tagType=
          "System.Web.UI.WebControls.WebParts.WebPartManager"
        mappedTagType=
          "Microsoft.Sharepoint.WebPartPartManager, 
           MSPS.Web.dll, Version='2.0.0.0'" 
      />
    </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"))

// 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"));