TagPrefixInfo 類別

定義

public ref class TagPrefixInfo sealed : System::Configuration::ConfigurationElement

public sealed class TagPrefixInfo : System.Configuration.ConfigurationElement

type TagPrefixInfo = class
    inherit ConfigurationElement

Public NotInheritable Class TagPrefixInfo
Inherits ConfigurationElement

繼承

Object

ConfigurationElement

TagPrefixInfo

範例

這個範例示範如何針對 區段的 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 、 TagName 和 Source 屬性。

• 如果是自訂控制項，您必須定義 TagPrefix 、 Namespace 和 Assembly 屬性。 Assembly如果控制項位於應用程式程式碼目錄中，則不需要 屬性。

相同的 tagPrefix 值可用來對應至多個元件或命名空間。

建構函式

屬性

方法

適用於

另請參閱

• PagesSection
• TagPrefixCollection