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 类允许以编程方式访问和修改 controls 配置文件节的子节 pages 。
TagPrefixInfo 对象使用元素添加到集合中 add ，并指定属性的值 tagPrefix 以及其他相关属性的值。 其他必需信息因将用于指定标记前缀的控件类型而异：
同一 tagPrefix 值可用于映射到多个程序集或命名空间。
备注
指定源时，用户控件本身不得与页面位于同一目录中。 如果是，尝试加载页面时会出现运行时错误。
构造函数
| TagPrefixInfo(String, String, String, String, String) |
使用传递的值初始化 TagPrefixInfo 类的新实例。 |