Artigo: 815174 - Última revisão: domingo, 13 de Maio de 2007 - Revisão: 1.10

Como criar aplicações e definições de configuração específicas do directório de uma aplicação do ASP.NET

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Reduzir tudo

Sumário

Este artigo passo a passo descreve como utilizar o ASP.NET para efectuar definições de configuração específicas de directório e específicas da aplicação. O Ficheiro Web.config reside no directório raiz de uma aplicação do ASP.NET. O ficheiro Web.config especifica informações de configuração específicas para a aplicação. Também pode definir as definições de configuração numa base por directório. Existem duas formas para o fazer:
  • Distribua vários ficheiros Web.config para directórios na aplicação. Adicione um ficheiro Web.config no directório de aplicação do ASP.NET com definições que substituem as definições num ficheiro Web.config nível superior ou no ficheiro de configuração (Machine.config) do computador de sistema.
  • Adicionar por directório por-ficheiro ou definições directamente para o ficheiro Web.config da aplicação. Este método utiliza um único ficheiro Web.config para activar definições de configuração por directório. Também pode utilizar este método no ficheiro Machine.config para forçar definições de configuração nas aplicações Web do ASP.NET e em seguida, parar ficheiros Web.config de substituir Machine.config definições.


Utilize o elemento de localização no ficheiro Machine.config


Para especificar as definições aplicáveis a um aplicativo da Web ou o directório, pode adicionar o < localização > elemento para o < configuração > elemento de um ficheiro Machine.config do sistema. Isto é útil quando centralizar as definições de configuração num único ficheiro. Também é útil em ambientes de alojamento na Web para mandate configurações específicas em aplicações Web individuais.

O <location> elemento contém dois atributos, caminho e allowOverride . Define o atributo de caminho de site ou directório virtual que abrangem as definições de configuração. Para especificar que as definições de <location> elemento aplicar para o Web site predefinido, definir o atributo caminho para o Web Site predefinido . Para especificar que as definições aplicam-se a aplicação que chama MyApp no Web site predefinido, defina o atributo de caminho para "Default Web site/MyApp" .

Quando o atributo allowOverride é false , os ficheiros Web.config os directórios de aplicação Web não é possível substituir as definições que especificou no <location> elemento. Esta é uma definição útil em ambientes onde deve restringir programadores de aplicações no como configurarem uma aplicação Web. O exemplo seguinte mostra uma parte de um ficheiro Machine.config que requer autenticação para aceder à aplicação MyApp no Web site predefinido e que não pode ser substituída pelas definições num ficheiro Web.config:
<configuration>
    <location path=?Default Web Site/MyApp? allowOverride=?false?>
        <system.web>
            <authorization>
                <allow users=??? />
            </authorization>
        </system.web>
    </location>
</configuration>




Utilize o elemento de localização no ficheiro Web.config


Para especificar as definições aplicáveis a uma aplicação específica ou directório, adicione o < localização > elemento para o < configuração > elemento de um ficheiro Web.config da aplicação. O < localização > elemento contém normalmente um < System.Web > elemento e outros elementos de configuração exactamente como o utilizá-las no ficheiro Web.config. Oatributo de caminho o < localização > elemento Especifica o directório virtual ou o nome do ficheiro onde aplicam os itens de configuração de localização. O exemplo seguinte mostra parte de um ficheiro Web.config de aplicação que especifica mensagens de erro personalizadas para o directório virtual fórum.
<configuration>
    <location path=?forum? >
        <system.web>
            <customErrors mode="RemoteOnly? defaultRedirect="forum-error.aspx">
                <error statusCode="404" redirect="forum-file-not-found.aspx" />
            </customErrors>
        </system.web>
    </location>
</configuration>




Referências

Para obter informações adicionais, clique no número de artigo que se segue para visualizar o artigo na Microsoft Knowledge Base:
818016  (http://support.microsoft.com/kb/818016/ ) Como implementar aplicações que tem foi criadas no .NET Framework
Para obter mais informações, visite os seguintes Web sites da Microsoft Developer Network:

Configuração do ASP.NET
http://msdn2.microsoft.com/en-us/library/aa719558(VS.71).aspx (http://msdn2.microsoft.com/en-us/library/aa719558(VS.71).aspx)

Formato de ficheiros de configuração do ASP.NET
http://msdn2.microsoft.com/en-us/library/ackhksh7(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/ackhksh7(vs.71).aspx)

Implementar aplicações
http://msdn2.microsoft.com/en-us/library/ybshs20f(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/ybshs20f(vs.71).aspx)

A informação contida neste artigo aplica-se a:
  • Microsoft ASP.NET 1.0
  • Microsoft ASP.NET 1.1
Palavras-chave: 
kbmt kbdir kbwebservices kbwebserver kbwebforms kbconfig kbhowtomaster KB815174 KbMtpt
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine translation ou MT), não tendo sido portanto revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais. O objectivo é simples: oferecer em Português a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradução automática não é sempre perfeita. Esta pode conter erros de vocabulário, sintaxe ou gramática? erros semelhantes aos que um estrangeiro realiza ao falar em Português. A Microsoft não é responsável por incoerências, erros ou estragos realizados na sequência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualizações frequentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 815174  (http://support.microsoft.com/kb/815174/en-us/ )