Element add podelementu controls elementu pages (schéma nastavení ASP.NET)

Článek
08/11/2011

Přidá předpony značek do kolekce předpon značek použitých při předkompilaci.

Tento element je v rozhraní .NET Framework verze 2.0 nový.

<add
   assembly="assembly"
   namespace="namespace"
   src="file path"
   tagName="tag name"
   tagPrefix="tag prefix"
>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
assembly	Volitelný String atributu. Určuje název sestavení, které obsahuje implementaci ovládacího prvku modelu COM a vyžaduje, aby byl atribut namespace také nastaven.
namespace	Nepovinný atribut String. Určuje obor názvů, který je spojen s prefixem značky a vyžaduje, aby byl také nastaven atribut assembly, pokud není ovládací prvek modelu COM umístěn v adresáři s kódem aplikace.
src	Nepovinný atribut String. Určuje název souboru, který obsahuje implementaci uživatelského ovládacího prvku a vyžaduje, aby byl atribut tagName také nastaven.
tagName	Nepovinný atribut String. Určuje název ovládacího prvku pro použití na stránce a vyžaduje, aby byl atribut src také nastaven.
tagPrefix	Požadovaný atribut typu String. Určuje předponu značky, která je mapována na zdrojový soubor nebo obor názvů a sestavení. Tento atribut vyžaduje jednu z následujících kombinací ostatních atributů: namespace chcete-li definovat prvek modelu COM, pokud je ovládací prvek umístěn v adresáři kódu aplikace. namespace a assembly pro definici ovládacího prvku modelu COM. tagName a src pro definici uživatelského ovládacího prvku.
Zděděné atributy	Volitelné atributy. Atributy, které jsou děděny všemi prvky oddílu.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.
pages	Definuje nastavení konfigurace specifické pro stránku, jakými jsou například globální směrnice technologie ASP.NET, pro stránky a ovládací prvky, které jsou v oblasti působnosti konfiguračního souboru.
controls	Definuje kolekci registrovaných direktiv a oborů názvů, kde se předpony značek ukládají.

Poznámky

Element add přidá předponu značky do kolekce předpon značek v elementu controls, který se používá při předkompilaci.

Element controls definuje kolekci registrovaných direktiv a oborů názvů, kde se předpony značek ukládají. Tento element odpovídá direktivě @ Register na stránce technologie ASP.NET. Direktiva @ Register umožňuje zadat předpony značek pro uživatelské ovládací prvky.

Předpony značek spojují obor názvů v technologii ASP.NET do sestavení a obory názvů, které musí být zahrnuty, aby model COM a uživatelské ovládací prvky pracovali správně. Následující informace jsou užitečné při konfiguraci elementu controls:

Při použití uživatelského ovládacího prvku, musíte definovat atributy tagPrefix, tagNamea source podřízeného elementu add.
Při použití vlastního ovládacího prvku, musíte definovat atributy tagPrefix, namespacea assembly podřízeného elementu add. Atribut assembly není vyžadován, pokud je ovládací prvek umístěn v adresáři kódu aplikace.

Můžete použít stejnou hodnotu tagPrefix k mapování do více sestavení nebo oborů názvů.

Výchozí konfigurace

Následující výchozí controls prvek nastaven v souboru Web.config kořenový.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

Příklad

Následující příklad kódu ukazuje, jak deklarativně zadat hodnoty pro několik atributů elementu controls, který lze také přistupovat programově jako členové třídy TagPrefixInfo.

   <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="controls/MyControl.ascx"/>
      </controls>
   </pages>

Informace prvku

Obslužná rutina konfiguračního oddílu	PagesSection
Konfigurační člen	Add
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework verze 2.0 Microsoft Visual Studio 2005

Viz také

Sdílet prostřednictvím

Element add podelementu controls elementu pages (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály