Visão Geral da Configuração ASP.NET

Artigo
10/15/2014

Using the features of the ASP.NET configuration system, you can configure all of the ASP.NET applications on an entire server, a single ASP.NET application, or individual pages or application subdirectories.You can configure features, such as authentication modes, page caching, compiler options, custom errors, debug and trace options, and much more.

The following sections describe the features of the ASP.NET configuration system.

For information about configuring .NET Framework client applications, see Configurando aplicativos.

Observação:
The features of the ASP.NET configuration system only apply to ASP.NET resources.For example, Forms Authentication only restricts access to ASP.NET files, not to static files or ASP (classic) files unless those resources are mapped to ASP.NET file name extensions.Use the configuration features of Internet Information Services (IIS) to configure non-ASP.NET resources.Para obter informações, consulte Trabalhando com a Metabase do IIS and Referência de propriedades de Metabase do IIS.

The features of the ASP.NET configuration system only apply to ASP.NET resources.For example, Forms Authentication only restricts access to ASP.NET files, not to static files or ASP (classic) files unless those resources are mapped to ASP.NET file name extensions.Use the configuration features of Internet Information Services (IIS) to configure non-ASP.NET resources.Para obter informações, consulte Trabalhando com a Metabase do IIS and Referência de propriedades de Metabase do IIS.

Configuration Files

Dados de configuração do ASP.NET são armazenados em arquivos de texto XML que cada um nomeado Web.config.Arquivos Web.config podem aparecer em vários diretórios em aplicativos ASP.NET.These files allow you to easily edit configuration data before, during, or after applications are deployed on the server.You can create and edit ASP.NET configuration files by using standard text editors, the ASP.NET MMC snap-in, the Web Site Administration Tool, or the ASP.NET configuration API.

ASP.NET configuration files keep application configuration settings separate from application code.Keeping configuration data separate from code makes it easy for you to associate settings with applications, change settings as needed after deploying an application, and extend the configuration schema.

For more information about how data is organized in ASP.NET configuration files, see Arquivos de configuração ASP.NET.Available configuration settings are described in the Definições de configuração ASP.NET.

Configuration File Hierarchy and Inheritance

Each Web.config file applies configuration settings to the directory that it is in and to all of the child directories below it.Configurações em diretórios filho podem, opcionalmente, substituir ou modificar as configurações que estão especificadas nos diretórios pai.Configuration settings in a Web.config file can optionally be applied to individual files or subdirectories by specifying a path in a location element.

The root of the ASP.NET configuration hierarchy is the systemroot\Microsoft.NET\Framework\versionNumber\CONFIG\Web.config file, which includes settings that apply to all ASP.NET applications that run a specific version of the .NET Framework.Porque cada aplicativo ASP.NET herda configurações padrão do arquivo Web.config raiz, você precisará criar arquivos Web.config somente para as configurações que substituem as configurações padrão.

Observação:
A raiz Web.config arquivo herda algumas configurações básicas de configuração dos Machine.config arquivo localizado no mesmo diretório.Algumas dessas configurações não podem ser substituídas em Web.config arquivos.Para obter mais informações, consulte Hierarquia e Herança do Arquivo de Configuração do ASP.NET.

At run time, ASP.NET uses the Web.config files to hierarchically compute a unique collection of configuration settings for each incoming URL request.These settings are calculated only once and then cached on the server.ASP.NET detects any changes to the configuration files and then automatically applies those changes to the affected applications, restarting the applications in most cases.Hierarchical configuration settings are automatically calculated and cached again whenever a configuration file in the hierarchy is changed.The IIS server does not have to be restarted for the changes to take effect unless the processModel section has been changed.

For more information about how the ASP.NET configuration hierarchy works, see Hierarquia e Herança do Arquivo de Configuração do ASP.NET and Cenários de configuração ASP.NET.

Directly Editing Configuration Files

You can use a text editor or an XML editor to edit the configuration files directly.For proper syntax, see the reference topics in the configuration sections in Definições de configuração ASP.NET and Configurações gerais (ASP.NET).Para obter mais informações, consulte Editando Arquivos de Configuração ASP.NET.

Elementos de configuração adicionais do ASP.NET 3.5 arquivo Web.config

O arquivo Web.config para ASP.NET um aplicativo que tem como alvo o .NET estrutura versão 3.5 contém elementos de configuração que não são encontrados no s arquivo Web.config para versões anteriores.Isso expandido arquivo Web.config também é criado quando você abre um site existente no e atualizar o site para o .NET estrutura versão 3.5 de destino.Nesse caso, o Visual Studio atualiza o arquivo de Web.config do aplicativo para incluir elementos adicionais de configuração.

A tabela a seguir mostra os novos elementos de configuração e as alterações em elementos da configuração de versões anteriores do .NET estrutura.

Elemento de configuração	Alterações na versão 3.5
system.codedom	(Nova seção) Especifica como o .NET estrutura Code documento objeto modelo (Code Model, CodeDOM) deve compilar o código-fonte em time de execução.
configSections	(Nova seção) Define o system.web.extensions seção que é usada pelo ASP.NET AJAX para definir como os serviços da Web forem chamados de script de cliente. Para obter mais informações, consulte Serviços Web em ASP.NET AJAX.
assemblies	(Nova seção no compilation elemento) Especifica a coleção de módulos (assemblies) referenciados quando páginas ASP.NET são compiladas. Esta seção inclui os assemblies que são novos para ASP.NET versão 3.5.
namespaces	(Seção atualizada) Esta seção especifica quais espaços para nome são importados por padrão.The Linq, Linq, e Generic espaços para nome foi adicionados.
controls	(Updated section) This section registers assemblies that contain controls, and provides a prefix to reference the control, similar to the way the Diretivas para páginas web ASP.NET page directive registers controls in an individual page.Por padrão, esta seção registra controles no Extensions assembly. Elas incluem o controle ListView e controles relacionados ao AJAX.
system.webServer	Esta seção substitui a relacionados ao AJAX manipuladores e módulos que são adicionados no httpHandlers e httpModules seções. Esta seção disponibiliza manipuladores e módulos para IIS 7.0 quando ele é executado no modo integrado.
assemblyBinding	(Seção atualizada) Esta seção direciona o tempo de execução para usar a estrutura ASP.NET AJAX que faz parte da versão 3.5 em vez de usar qualquer versão anterior da estrutura ASP.NET AJAX ASP.NET.

Configuration Tools

The ASP.NET configuration system provides tools that make application configuration easier than using a text editor because they include error detection.

ASP.NET MMC Snap-in

The Microsoft Management Console (MMC) snap-in for ASP.NET provides a convenient way to manipulate ASP.NET configuration settings at all levels on a local or remote Web server.The ASP.NET MMC snap-in uses the ASP.NET configuration API, but it simplifies the process of editing configuration settings by providing a graphical user interface (GUI).In addition, the tool supports the ASP.NET configuration API features that control whether settings can be inherited by Web applications, and manage the dependencies between levels of the configuration hierarchy.

Observação:
To use the ASP.NET MMC snap-in, you must log on to the computer with an account that has administrative privileges.

The ASP.NET MMC snap-in appears as an ASP.NET tab on the property sheet of a virtual directory.

Para obter mais informações, consulte Snap-in do MMC do ASP.NET.

Web Site Administration Tool

The Web Site Administration Tool allows anyone with administrative privileges for the Web site to manage the configuration settings for that Web site.The Web Site Administration Tool is designed to provide a user-friendly, graphical editing tool for the configuration settings that are most commonly used in individual Web sites.Because the tool uses a browser-based interface, it allows you to change Web site settings remotely, which is useful for administering a site that is already deployed to a production Web server, such as a hosted Web site.

The Web Site Administration Tool differs from the ASP.NET MMC snap-in in several ways.For instance, the ASP.NET MMC snap-in is ideal for administrator-level configuration because it provides access to the entire hierarchy of configuration files on the Web server instead of the configuration settings for a single Web site.Also, you must be an administrator to use the ASP.NET MMC snap-in, whereas the Web Site Administration Tool only allows individual Web site owners to configure the Web.config file in the root directory of sites to which they have administrative privileges.Finally, you cannot use the ASP.NET MMC snap-in to administer IIS remotely, but the browser interface for the Web Site Administration Tool allows remote configuration for versions of IIS beginning with IIS 6.0.

The Web Site Administration Tool includes a tabbed interface that groups related configuration settings on the following tabs:

A Security tab, which contains settings to help secure Web-application resources and to manage user accounts and roles.
A Profile tab, which contains settings to manage how visitor information is gathered by the Web site.
An Application tab, which contains settings to manage configuration elements that affect ASP.NET applications.
A Provider tab, which contains settings to add, edit, delete, test, or assign application providers.

ferramenta de Administração de Site é automaticamente instalado com o .NET estrutura versão 2.0 e posterior.For information about how the tool works, see Ferramenta de Admnistração de Web Site ASP.NET.

Ferramentas de Linha de Comando

The .NET Framework includes command-line tools that perform specific configuration operations.For example, the Aspnet_regiis.exe tool allows you to specify which version of the .NET Framework applies to your ASP.NET application.Para obter mais informações, consulte Ferramentas.NET Framework.

API de Configuração do ASP.NET

The ASP.NET configuration system provides a complete managed interface for programmatically configuring ASP.NET applications without directly editing the XML configuration files.In addition, the ASP.NET configuration API does the following:

Simplifies administrative tasks by providing an integrated view of data from all levels of the configuration hierarchy.
Supports deployment tasks, including creating configurations and configuring multiple computers with one script.
Provides a single programming interface for developers who build ASP.NET applications, console applications and scripts, Web-based management tools, and MMC snap-ins.
Prevents developers and administrators from making invalid configuration settings.
Allows you to extend the configuration schema.You can define new configuration parameters and write configuration section handlers to process them.
Provides static methods for obtaining configuration information from the application that is currently running, and non-static methods for obtaining configuration information from a separate application.Using static methods allows your application to run faster, but these methods can only be used from within the application about which you are obtaining configuration data.

Para obter mais informações, consulte API de Configuração do ASP.NET.

Configuration Security

The ASP.NET configuration system helps protect configuration files from access by unauthorized users.ASP.NET configures IIS to deny access to any browser that requests access to the Machine.config or Web.config files.HTTP access error 403 (Forbidden) is returned to any browser that attempts to request a configuration file directly.

Additionally, configuration files in one ASP.NET application are prevented from accessing configuration settings in other ASP.NET applications unless your configuration application is running in Full trust under an account that has permissions to read the configuration file in the other application.

Para obter mais informações, consulte Protegendo configuração ASP.NET e Criptografando informações de configuração usando configuração protegida.

Consulte também

Compartilhar via