TagPrefixInfo Třída

Definice

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

Dědičnost

Object

ConfigurationElement

TagPrefixInfo

Příklady

Tento příklad ukazuje, jak zadat hodnoty deklarativní pro několik atributů oddílu controls , ke kterým lze přistupovat také jako členové TagPrefixInfo třídy.

<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>  

Následující příklad kódu ukazuje, jak pomocí TagPrefixInfo třídy programově upravit nastavení předpony značky. Tento příklad kódu je součástí většího příkladu zadaného PagesSection pro třídu.

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

Poznámky

Třída TagPrefixInfo umožňuje programově přistupovat a upravovat informace o předponě značek uložené v konfiguračním souboru. Poskytuje stejné funkce jako direktiva ASP.NET@Register. Předpony značek přidružují "obor názvů" v ASP.NET k sestavením a oborům názvů, které musí být součástí vlastních ovládacích prvků a uživatelských ovládacích prvků, aby správně fungovaly. TagPrefixInfo objekty se ukládají jako členy objektu TagPrefixCollection . Třída TagPrefixCollection umožňuje programově přistupovat a upravovat controls dílčí část pages oddílu konfiguračního souboru.

TagPrefixInfo objekty se přidají do kolekce pomocí elementu add a určují hodnotu atributu tagPrefix spolu s hodnotami pro další relevantní atributy. Ostatní požadované informace se liší podle typu ovládacího prvku, který použijete se zadanou předponou značky:

• Pokud se jedná o uživatelský ovládací prvek, musíte definovat TagPrefix, TagNamea Source vlastnosti.

• Pokud je to vlastní ovládací prvek, musíte definovat TagPrefix, Namespacea Assembly vlastnosti. Vlastnost Assembly není nutná, pokud je ovládací prvek v adresáři kódu aplikace.

Stejnou tagPrefix hodnotu lze použít k mapování na více sestavení nebo oborů názvů.

Konstruktory

Vlastnosti

Metody

Platí pro

Viz také

• PagesSection
• TagPrefixCollection