TagPrefixInfo クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タグ関連の情報を含む構成要素を定義します。
public ref class TagPrefixInfo sealed : System::Configuration::ConfigurationElementpublic sealed class TagPrefixInfo : System.Configuration.ConfigurationElementtype TagPrefixInfo = class
inherit ConfigurationElementPublic NotInheritable Class TagPrefixInfo
Inherits ConfigurationElement- 継承
例
この例では、 controls セクションのいくつかの属性に対して宣言的に値を指定する方法を示します。これは、 TagPrefixInfo クラスのメンバーとしてもアクセスできます。
<system.web>
<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" src="MyControl.ascx"/>
</controls>
</pages>
</system.web>
次のコード例は、 TagPrefixInfo クラスを使用して、プログラムによってタグ プレフィックスの設定を変更する方法を示しています。 このコード例は、 PagesSection クラスに提供されるより大きな例の一部です。
// Get all current Controls in the collection.
for (int i = 0; i < pagesSection.Controls.Count; i++)
{
Console.WriteLine("Control {0}:", i);
Console.WriteLine(" TagPrefix = '{0}' ",
pagesSection.Controls[i].TagPrefix);
Console.WriteLine(" TagName = '{0}' ",
pagesSection.Controls[i].TagName);
Console.WriteLine(" Source = '{0}' ",
pagesSection.Controls[i].Source);
Console.WriteLine(" Namespace = '{0}' ",
pagesSection.Controls[i].Namespace);
Console.WriteLine(" Assembly = '{0}' ",
pagesSection.Controls[i].Assembly);
}
// Create a new TagPrefixInfo object.
System.Web.Configuration.TagPrefixInfo tagPrefixInfo =
new System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx");
// Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo);
// Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add(
new System.Web.Configuration.TagPrefixInfo(
"MyCtrl", "MyNameSpace", "MyAssembly", "MyControl",
"MyControl.ascx"));
' Get all current Controls in the collection.
Dim j As Int32
For j = 0 To pagesSection.Controls.Count - 1
Console.WriteLine("Control {0}:", j)
Console.WriteLine(" TagPrefix = '{0}' ", _
pagesSection.Controls(j).TagPrefix)
Console.WriteLine(" TagName = '{0}' ", _
pagesSection.Controls(j).TagName)
Console.WriteLine(" Source = '{0}' ", _
pagesSection.Controls(j).Source)
Console.WriteLine(" Namespace = '{0}' ", _
pagesSection.Controls(j).Namespace)
Console.WriteLine(" Assembly = '{0}' ", _
pagesSection.Controls(j).Assembly)
Next
' Create a new TagPrefixInfo object.
Dim tagPrefixInfo As System.Web.Configuration.TagPrefixInfo = _
New System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx")
' Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo)
' Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add( _
New System.Web.Configuration.TagPrefixInfo( _
"MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", _
"MyControl.ascx"))
注釈
TagPrefixInfo クラスを使用すると、構成ファイルに格納されているタグ プレフィックス情報にプログラムでアクセスして変更できます。 ASP.NET @Register ディレクティブと同じ機能を提供します。 タグ プレフィックスは、カスタム コントロールとユーザー コントロールが正常に動作するために含める必要があるアセンブリと名前空間に、ASP.NET の "名前空間" を関連付けます。
TagPrefixInfo オブジェクトは、 TagPrefixCollection オブジェクトのメンバーとして格納されます。
TagPrefixCollection クラスを使用すると、構成ファイルの pages セクションの controls サブセクションにプログラムでアクセスして変更できます。
TagPrefixInfo オブジェクトは、 add 要素を使用してコレクションに追加され、 tagPrefix 属性の値と、その他の関連する属性の値を指定します。 その他の必要な情報は、指定したタグ プレフィックスで使用するコントロールの種類によって異なります。
ユーザー コントロールの場合は、 TagPrefix、 TagName、および Source プロパティを定義する必要があります。
カスタム コントロールの場合は、 TagPrefix、 Namespace、および Assembly プロパティを定義する必要があります。 コントロールがアプリケーション コード ディレクトリにある場合、 Assembly プロパティは必要ありません。
同じ tagPrefix 値を使用して、複数のアセンブリまたは名前空間にマップできます。
注
ソースが指定されている場合、ユーザー コントロール自体がページと同じディレクトリに含まれていない必要があります。 その場合は、ページを読み込もうとしたときに実行時エラーが発生します。
コンストラクター
| 名前 | 説明 |
|---|---|
| TagPrefixInfo(String, String, String, String, String) |
渡された値を使用して、 TagPrefixInfo クラスの新しいインスタンスを初期化します。 |
