TagPrefixInfo Třída

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Definuje element konfigurace obsahující informace související se značkami.

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

Poznámka

Pokud je zdroj zadán, uživatelský ovládací prvek samotný nesmí být ve stejném adresáři jako stránka. Pokud ano, zobrazí se při pokusu o načtení stránky chyba za běhu.

Konstruktory

TagPrefixInfo(String, String, String, String, String)

Inicializuje novou instanci TagPrefixInfo třídy pomocí předaných hodnot.

Vlastnosti

Assembly	Získá nebo nastaví název sestavení obsahující implementaci ovládacího prvku.
CurrentConfiguration	Získá odkaz na instanci nejvyšší úrovně Configuration , která představuje hierarchii konfigurace, do které aktuální ConfigurationElement instance patří. (Zděděno od ConfigurationElement)
ElementInformation	ElementInformation Získá objekt, který obsahuje neuzpůsobitelné informace a funkce objektuConfigurationElement. (Zděděno od ConfigurationElement)
ElementProperty	ConfigurationElementProperty Získá objekt, který představuje ConfigurationElement samotný objekt. (Zděděno od ConfigurationElement)
EvaluationContext	ContextInformation Získá objekt objektuConfigurationElement. (Zděděno od ConfigurationElement)
HasContext	Získá hodnotu, která označuje, zda CurrentConfiguration je nullvlastnost . (Zděděno od ConfigurationElement)
Item[ConfigurationProperty]	Získá nebo nastaví vlastnost nebo atribut tohoto konfiguračního prvku. (Zděděno od ConfigurationElement)
Item[String]	Získá nebo nastaví vlastnost, atribut nebo podřízený prvek tohoto konfiguračního prvku. (Zděděno od ConfigurationElement)
LockAllAttributesExcept	Získá kolekci uzamčených atributů. (Zděděno od ConfigurationElement)
LockAllElementsExcept	Získá kolekci uzamčených prvků. (Zděděno od ConfigurationElement)
LockAttributes	Získá kolekci uzamčených atributů. (Zděděno od ConfigurationElement)
LockElements	Získá kolekci uzamčených prvků. (Zděděno od ConfigurationElement)
LockItem	Získá nebo nastaví hodnotu určující, zda je prvek uzamčen. (Zděděno od ConfigurationElement)
Namespace	Získá nebo nastaví obor názvů, ve kterém se ovládací prvek nachází.
Properties	Získá kolekci vlastností. (Zděděno od ConfigurationElement)
Source	Získá nebo nastaví název a cestu souboru obsahujícího uživatelský ovládací prvek.
TagName	Získá nebo nastaví název uživatelského ovládacího prvku.
TagPrefix	Získá nebo nastaví předponu značky, která je přidružena ke zdrojovému souboru nebo oboru názvů a sestavení.

Metody

DeserializeElement(XmlReader, Boolean)	Načte XML z konfiguračního souboru. (Zděděno od ConfigurationElement)
Equals(Object)	Porovná tuto instanci s jiným objektem.
GetHashCode()	Vrátí hodnotu hash aktuální instance.
GetTransformedAssemblyString(String)	Vrátí transformovanou verzi zadaného názvu sestavení. (Zděděno od ConfigurationElement)
GetTransformedTypeString(String)	Vrátí transformovanou verzi zadaného názvu typu. (Zděděno od ConfigurationElement)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
Init()	ConfigurationElement Nastaví objekt na počáteční stav. (Zděděno od ConfigurationElement)
InitializeDefault()	Slouží k inicializaci výchozí sady hodnot objektu ConfigurationElement . (Zděděno od ConfigurationElement)
IsModified()	Označuje, zda byl tento element konfigurace změněn od posledního uložení nebo načtení, při implementaci v odvozené třídě. (Zděděno od ConfigurationElement)
IsReadOnly()	Získá hodnotu určující, zda ConfigurationElement objekt je jen pro čtení. (Zděděno od ConfigurationElement)
ListErrors(IList)	Přidá chyby neplatné vlastnosti v tomto ConfigurationElement objektu a ve všech dílčích počtech do předaného seznamu. (Zděděno od ConfigurationElement)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnDeserializeUnrecognizedAttribute(String, String)	Získá hodnotu označující, zda je zjištěn neznámý atribut během deserializace. (Zděděno od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Získá hodnotu označující, zda je při deserializaci zjištěn neznámý prvek. (Zděděno od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Vyvolá výjimku, když se nenajde požadovaná vlastnost. (Zděděno od ConfigurationElement)
PostDeserialize()	Volá se po deserializaci. (Zděděno od ConfigurationElement)
PreSerialize(XmlWriter)	Volá se před serializací. (Zděděno od ConfigurationElement)
Reset(ConfigurationElement)	Obnoví vnitřní stav objektu ConfigurationElement , včetně zámků a kolekcí vlastností. (Zděděno od ConfigurationElement)
ResetModified()	Obnoví hodnotu IsModified() metody na false při implementaci v odvozené třídě. (Zděděno od ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Zapíše obsah tohoto konfiguračního prvku do konfiguračního souboru při implementaci v odvozené třídě. (Zděděno od ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Zapíše vnější značky tohoto konfiguračního prvku do konfiguračního souboru při implementaci v odvozené třídě. (Zděděno od ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Nastaví vlastnost na zadanou hodnotu. (Zděděno od ConfigurationElement)
SetReadOnly()	IsReadOnly() Nastaví vlastnost pro ConfigurationElement objekt a všechny dílčí prvky. (Zděděno od ConfigurationElement)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Upraví objekt tak, ConfigurationElement aby odebral všechny hodnoty, které by neměly být uloženy. (Zděděno od ConfigurationElement)

Viz také

• PagesSection
• TagPrefixCollection