Adicionar elemento para controles de páginas (ASP.NET Configurações Schema)

Artigo
08/04/2011

Adiciona um prefixo de marca para a coleção de prefixos de marca que são usados durante a pré-compilação.

Esse elemento é novo no .NET Framework versão 2.0.

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo	Descrição
assembly	Opcional String atributo. Especifica o nome do assembly que contém a implementação de controle COM e requer que o namespace atributo é também definido.
namespace	Opcional String atributo. Especifica o namespace que está associado com o prefixo da marca e requer que o assembly atributo também for definido, se o controle COM não está localizado no diretório de código de aplicativo.
src	Opcional String atributo. Especifica o nome do arquivo que contém o controle de usuário e requer que o tagName atributo é também definido.
tagName	Opcional String atributo. Especifica o nome do controle para usar na página e requer que o src atributo é também definido.
tagPrefix	Obrigatório String atributo. Especifica o prefixo de marca que está sendo mapeado para um arquivo de origem ou o espaço para nome e o assembly. Este atributo requer uma das seguintes combinações de outros atributos: namespacePara definir um controle COM, se o controle estiver no diretório de código do aplicativo. namespacee assembly para definir um controle COM. tagNamee src para definir um controle de usuário.
Atributos herdados	Atributos opcionais. Atributos herdados por todos os elementos de seção.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.
system.web	Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.
pages	Define configurações específicas da página de configuração, como, por exemplo, global ASP.NET diretivas para páginas e controles que estão dentro do escopo do arquivo de configuração.
controls	Define um conjunto de diretivas register e os espaços para nome onde residem os prefixos de marca.

Comentários

O add elemento adiciona um prefixo de marca para a coleção de prefixos de marca na controles o elemento que são usados durante a pré-compilação.

O controles elemento define um conjunto de diretivas register e os espaços para nome onde residem os prefixos de marca. Este elemento corresponde do @ Register a diretiva em uma página ASP.NET page. O @ Register diretiva permite que você especifique o prefixo de marca para um controle de usuário.

Marca prefixos associar um namespace em ASP.NET assemblies e namespaces que deve ser incluído para controles de usuário e COM funcione corretamente. As informações a seguir serão útil ao configurar o controls elemento:

Se aplicado a um controle de usuário, você deve definir o tagPrefix, tagName, e source atributos a Adicionar elemento filho.
Se aplicado a um controle personalizado, você deve definir o tagPrefix, namespace, e assembly atributos a Adicionar elemento filho. O assembly atributo está não é necessário, se o controle estiver no diretório de código de aplicativo.

Você pode usar o mesmo tagPrefix valor para mapear vários assemblies ou namespaces.

Configuração padrão

O seguinte padrão controls elemento é configurado no arquivo Web. config raiz.

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

Exemplo

O exemplo de código a seguir demonstra como especificar valores declarativamente para vários atributos da controles elemento, que também pode ser acessado programaticamente como membros do TagPrefixInfo classe.

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

Informações do elemento

Manipulador da seção de configuração	PagesSection
Membro de configuração	Add
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Virtual ou física directory–level Web. config
Requisitos	De da (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 2.0 Microsoft Visual Studio 2005

Consulte também

Compartilhar via

Adicionar elemento para controles de páginas (ASP.NET Configurações Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais