Partilhar via


Elemento de controles para páginas (ASP.NET Settings esquema)

Define um coleção de diretivas de registro e os espaços para nome onde residem os prefixos da marca.

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)

<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 tag à coleção de prefixos de marca usadas durante a pré-compilação.

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 específicas da página globalmente, tais sistema autônomo sistema autônomo diretivas do ASP.NET para páginas e controles que estão dentro do escopo do arquivo de configuração.

Comentários

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

Informações do elemento

Manipulador de seção de configuração

PagesSection

Configuração de membro

Controls

TagPrefixCollection

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 2003 ou o Visual Studio 2005

Consulte também

Tarefas

Como: Configurar diretórios específicos usando configurações de local

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo configuração ASP.NET

Referência

Páginas elemento (esquema configurações ASP.NET)

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

tagMapping elemento (ASP.NET Settings esquema) de páginas

Namespaces de elemento para páginas (ASP.NET Settings esquema)

System.Web elemento (esquema configurações ASP.NET) 

configuração elemento (Geral Settings esquema)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

Outros recursos

Configurações gerais (ASP.NET)

Definições de configuração ASP.NET

Administrando ites da Web do ASP.NET

API de Configuração do ASP.NET