Adicionar elemento para controles para páginas (ASP.NET Settings esquema)

Artigo
08/25/2010

Adiciona um prefixo de tag à coleção de prefixos de marca usadas durante a pré-compilação.

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

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET)
    Páginas elemento (esquema configurações ASP.NET)
      Elemento de controles para páginas (ASP.NET Settings esquema)
        Adicionar elemento para controles para páginas (ASP.NET Settings esquema)

<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 do controle COM e requer que o namespace atributo também é conjunto.
namespace	Opcional String atributo. Especifica o namespace que está associado com o prefixo da marca e requer que o assembly atributo também é conjunto, se o controle COM não estiver localizado no diretório de código do 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 é conjunto.
tagName	Opcional String atributo. Especifica o nome do controle para usar na página e requer que o src atributo também será definido.
tagPrefix	Necessário String atributo. Especifica o prefixo de marca está sendo mapeado para um arquivo de fonte ou o espaço para nome e o assembly. Este atributo requer um dos seguintes combinações de outros atributos: namespace Para definir um controle COM, se o controle estiver no diretório de código do aplicativo. namespace e assembly Para definir um controle COM. tagName e 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 exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.
system.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.
pages	Define configurações de configurações específicas de página, sistema autônomo sistema autônomo diretivas ASP.NET global, para páginas e controles que estão dentro do escopo do arquivo de configuração.
controls	Define um coleção de diretivas de registro e os espaços para nome onde residem os prefixos da marca.

Comentários

The add elemento adiciona um prefixo de tag à coleção de prefixos de marca na controles elemento usados durante a pré-compilação.

The controles elemento define um conjunto de diretivas de registro e os espaços para nome onde residem os prefixos da marca. Este elemento corresponde ao @ Register diretiva em uma página ASP.NET. The @ Register directive allows you to specify the tag prefix for a user control.

Marca prefixos associar um namespace do ASP.NET para os módulos (assemblies) e espaços para nome que devem ser incluídos para controles de usuário e COM funcione corretamente. As seguintes informações são úteis ao configurar o controls elemento:

Se aplicado a um controle de usuário, você deve definir o tagPrefix, tagName, e source atributos da Adicionarelemento filho de .
Se aplicado a um controle personalizado, você deve definir o tagPrefix, namespace, e assembly atributos da Adicionarelemento filho de . The assembly atributo não é necessário, se o controle estiver no diretório de código do 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 está configurado na Web raiz. arquivo de configuração.

<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 sistema autônomo especificar valores declarativamente para vários atributos do controles elemento, que também pode ser acessado por meio de programação sistema autônomo 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 de seção de configuração	PagesSection
Configuração de membro	Add
Locais configuráveis	Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 O .NET estrutura versão 2.0 Microsoft Visual Studio 2005

Consulte também

Partilhar via

Adicionar elemento para controles para páginas (ASP.NET Settings esquema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais