Controla o elemento de páginas (ASP.NET Configurações Schema)

Artigo
08/04/2011

Define um conjunto de diretivas register e os espaços para nome onde residem os prefixos de marca.

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

<controls> 
   <add /> 
</controls>

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

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

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 globalmente, tais como ASP.NET diretivas para páginas e controles que estão dentro do escopo do arquivo de configuração.

Comentários

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

Informações do elemento

Manipulador da seção de configuração	PagesSection
Membro de configuração	Controls TagPrefixCollection
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 2003 ou 2005 de Visual Studio

Consulte também

Controla o elemento 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