Compartilhar via

Controla o elemento para páginas (ASP.NET Settings Schema)

  • Artigo

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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>

Attributes and Elements

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

Attributes

Nenhum.

Child Elements

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.

Parent Elements

Elemento

Descrição

configuration

Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.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 que 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 geradas para páginas e controles que estão dentro do escopo do arquivo de configuração.

Remarks

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 diretiva em uma página ASP.NET personalizada. O @ Register diretiva permite que você especifique o prefixo de marca para um controle de usuário.

Marca prefixos associar um espaço para nome no 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 na configuração do controls elemento:

  • Se aplicado a um controle de usuário, você deve definir o tagPrefix, tagName, e source atributos da Adicionar elemento filho.

  • Se aplicado a um controle personalizado, você deve definir o tagPrefix, namespace, e assembly atributos da Adicionar elemento filho. O assembly o 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 é 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 por meio de programação 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>

Element Information

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

Directory–level virtuais ou físicas Web. config

Requisitos

Serviços de Informações da Internet da Microsoft (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

Tasks

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Reference

páginas Element (ASP.NET Settings Schema)

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

tagMapping elemento para páginas (ASP.NET Settings Schema)

namespaces de elemento para pages (ASP.NET Settings Schema)

System. Web Element (ASP.NET Settings Schema)

configuração Element (General Settings Schema)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

Concepts

ASP.NET Configuration File Hierarchy

Securing Configuration

Other Resources

Configurações gerais (ASP.NET)

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

Configuring ASP.NET Applications

ASP.NET Configuration API