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 中的 「namespace」 關聯至必須包含的元件和命名空間，才能讓自訂控制項和使用者控制項正常運作。
TagPrefixInfo 物件會儲存為 物件的成員 TagPrefixCollection 。 類別 TagPrefixCollection 可讓您以程式設計方式存取和修改 controls 組態檔區段的 pages 子區段。
TagPrefixInfo 物件會使用 專案新增至集合， add 並指定屬性的值 tagPrefix ，以及其他相關屬性的值。 其他必要資訊會根據您將搭配指定的標籤前置詞使用的控制項種類而有所不同：
相同的 tagPrefix 值可用來對應至多個元件或命名空間。
注意
指定來源時，使用者控制項本身不得位於與頁面相同的目錄中。 如果是，當您嘗試載入頁面時，您會收到執行階段錯誤。
建構函式
| TagPrefixInfo(String, String, String, String, String) |
使用傳遞的值來初始化 TagPrefixInfo 類別的新執行個體。 |
