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 , které lze také získat přístup jako členy 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 uvedeného pro třídu 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"))

Poznámky

Třída TagPrefixInfo umožňuje programově přistupovat k informacím o předponě značek uložených v konfiguračním souboru a upravovat je. 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 zahrnuty pro správné fungování vlastních ovládacích prvků a uživatelských ovládacích prvků. TagPrefixInfo objekty jsou uloženy jako členy objektu TagPrefixCollection . Třída TagPrefixCollection umožňuje programově přistupovat a upravovat controls pododdíl pages oddílu konfiguračního souboru.

TagPrefixInfo objekty jsou přidány do kolekce pomocí add elementu a určení hodnoty 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 se jedná o vlastní ovládací prvek, musíte definovat TagPrefix, Namespacea Assembly vlastnosti. Vlastnost Assembly není vyžadována, 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 zadán zdroj, uživatelský ovládací prvek samotný nesmí být ve stejném adresáři jako stránka. Pokud ano, při pokusu o načtení stránky se zobrazí chyba za běhu.

Konstruktory

Name	Description
TagPrefixInfo(String, String, String, String, String)	Inicializuje novou instanci TagPrefixInfo třídy pomocí předaných hodnot.

Vlastnosti

Name	Description
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, ke které patří aktuální ConfigurationElement instance. (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	Získá objekt ContextInformation pro objekt ConfigurationElement. (Zděděno od ConfigurationElement)
HasContext	Získá hodnotu, která určuje, zda CurrentConfiguration je nullvlastnost . (Zděděno od ConfigurationElement)
Item[ConfigurationProperty]	Získá nebo nastaví vlastnost nebo atribut tohoto elementu konfigurace. (Zděděno od ConfigurationElement)
Item[String]	Získá nebo nastaví vlastnost, atribut nebo podřízený prvek tohoto konfiguračního elementu. (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 označující, zda je prvek uzamčen. (Zděděno od ConfigurationElement)
Namespace	Získá nebo nastaví obor názvů, ve kterém se nachází ovládací prvek.
Properties	Získá kolekci vlastností. (Zděděno od ConfigurationElement)
Source	Získá nebo nastaví název a cestu k 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

Name	Description
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 pro aktuální instanci.
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()	Získá Type aktuální instance. (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()	Určuje, zda byl tento konfigurační prvek změněn od jeho 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 poplatcích do předaného seznamu. (Zděděno od ConfigurationElement)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnDeserializeUnrecognizedAttribute(String, String)	Získá hodnotu určující, zda neznámý atribut je zjištěn během deserializace. (Zděděno od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Získá hodnotu určující, zda neznámý prvek je zjištěn během deserializace. (Zděděno od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Vyvolá výjimku, pokud nebyla nalezena požadovaná vlastnost. (Zděděno od ConfigurationElement)
PostDeserialize()	Volal 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