Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Elemento de appSettings do ASP.NET

O elemento <appSettings> na configuração contém as configurações para personalizar um aplicativo Web. Você pode add, remove e clear uma configuração de aplicativo como uma chave ou um par de valores no elemento <appSettings>.

<appSettings    <[add|clear|remove] key="configuration key value" value="value" /> </appSettings> 

aspnet:AllowAnonymousImpersonation

Especifica o tipo de token de representação usado quando a solicitação de entrada não é autenticada.

Type:

Boolean

Default value:

false

Remarks:

Essa chave appSettings especificamente está relacionada a SharePoint. Quando um aplicativo está executando um código possivelmente não confiável dentro de seu AppDomain, preste atenção na identidade em que o código não confiável é executado. Se esse valor de chave for false [padrão], determinados eventos de pipeline usarão o token de representação de identidade de processo se a solicitação de entrada não for autenticada. Se esse valor de chave for true, esses eventos de pipeline usarão um token de representação anônimo se a solicitação de entrada não for autenticada.

Example:

    <appSettings>
      <add key="aspnet:AllowAnonymousImpersonation" value="false" />
    </appSettings>
Observação importante Importante

Essa configuração só deve ser alterada por desenvolvedores experientes.

aspnet:AllowAsyncDuringSyncStages

Especifica se o ASP.NET executará verificações adicionais durante o tempo de execução para capturar erros comuns dos desenvolvedores ao executar a codificação assíncrona.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão] e o valor de chave UseTaskFriendlySynchronizationContext for true, o ASP.NET executará verificações adicionais durante o tempo de execução. Essas verificações capturam erros comuns que são cometidos na codificação assíncrona. Caso contrário, nenhuma verificação é executada. As verificações detectam erros como tentar iniciar uma operação assíncrona durante a execução de uma página síncrona ou fazer com que um IHttpModule ou um IHttpAsyncHandler seja concluído quando ainda houver operações assíncronas pendentes. Esses erros podem resultar em deadlock ou prejudicar o desempenho de um aplicativo ASP.NET.

Example:

    <appSettings>
      <add key="aspnet:AllowAsyncDuringSyncStages" value="false" />
    </appSettings>
aspnet:AllowRelaxedHttpUserName

Especifica como o ASP.NET sincroniza o nome de usuário do cliente entre as camadas gerenciadas (ASP.NET) e nativas (IIS) do servidor Web.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], o ASP.NET verificará o nome de usuário do cliente antes de executar essa etapa de sincronização. Se esse valor de chave for true, o ASP.NET não executará nenhuma verificação.

Example:

    <appSettings>
      <add key="aspnet:AllowRelaxedHttpUserName" value="false" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como true pode representar um risco à segurança.

aspnet:AllowRelaxedRelativeUrl

Especifica como as páginas de logon do ASP.NET redirecionarão para uma URL de retorno cujo destino esteja fora do aplicativo hospedado.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], as páginas de logon do ASP.NET não redirecionarão para uma URL de retorno cujo destino esteja fora do aplicativo hospedado. Se esse valor de chave for true, as páginas de logon do ASP.NET não executarão nenhuma verificação na URL de retorno e reorientarão para ela de qualquer maneira.

Example:

    <appSettings>
      <add key="aspnet:AllowRelaxedRelativeUrl" value="false" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como true pode representar um risco à segurança.

aspnet:AllowRelaxedUnicodeDecoding

Especifica se o ASP.NET executará a validação adicional de Unicode nos dados de entrada fornecidos pelo cliente.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], o ASP.NET executará a validação adicional de Unicode nos dados de entrada fornecidos pelo cliente. Se esse valor de chave for true, o ASP.NET não executará a validação adicional.

Example:

    <appSettings>
      <add key="aspnet:AllowRelaxedUnicodeDecoding" value="false" />
    </appSettings>
aspnet:AllowUtf7RequestContentEncoding

Especifica se os clientes podem especificar uma codificação para o cabeçalho Content-Encoding.

Type:

Boolean

Default value:

false

Remarks:

Por padrão, o ASP.NET permite que os clientes especifiquem a codificação de texto dos dados de entrada de carga. Os clientes podem enviar essas informações pelo cabeçalho Content-Encoding e o ASP.NET reflete essas informações na propriedade ContentEncoding. Se o valor de chave for false [padrão], os clientes não poderão usar o cabeçalho Content-Encoding para solicitar que o ASP.NET trate a carga de entrada como UTF-7. Se o valor de chave for true, os clientes poderão especificar qualquer codificação (inclusive UTF-7) para o cabeçalho Content-Encoding e o ASP.NET tentará interpretar a carga de entrada usando essa codificação. Para obter mais informações sobre UTF-7, consulte a classe UTF7Encoding.

Example:

    <appSettings>
      <add key="aspnet:AllowUtf7RequestContentEncoding" value="false" />
    </appSettings>
aspnet:DoNotDisposeSpecialHttpApplicationInstances

Especifica se o ASP.NET descarta instâncias “especiais” de todos os tipos de IHttpModule registrados que são usados para executar a instanciação de aplicativo.

Type:

Boolean

Default value:

false

Remarks:

Quando um aplicativo ASP.NET é iniciado pela primeira vez, as instâncias “especiais” de todos os tipos de IHttpModule registrados são criadas. Essas instâncias especiais são usadas para executar a instanciação de aplicativo. Essas instâncias especiais não são realmente usadas para solicitações de manutenção. Se o valor de chave for false [padrão], essas instâncias especiais serão descartadas (o IHttpModule implementa IDisposable) quando o aplicativo é desligado. Se esse valor de chave for true, essas instâncias especiais não serão descartadas.

Example:

    <appSettings>
      <add key="aspnet:DoNotDisposeSpecialHttpApplicationInstances" value="false" />
    </appSettings>
aspnet:FormsAuthReturnUrlVar

Especifica a URL de retorno para usar após a autenticação de formulários ter sido concluída.

Type:

String

Default value:

[cadeia de caracteres vazia]

Remarks:

Essa chave appSettings especificamente está relacionada a SharePoint. Quando esse valor de chave for definido, o valor será usado como a URL de retorno depois que o cliente do aplicativo Web tiver concluído a autenticação (registrada em log por meio da associação do ASP.NET). Se esse valor for deixado em branco, depois de concluir a autenticação, o cliente será redirecionado com base no parâmetro de cadeia de caracteres de consulta ReturnUrl usado ao autenticar.

Example:

    <appSettings>
      <add key="aspnet:FormsAuthReturnUrlVar" value="" />
    </appSettings>
aspnet:JavaScriptDoNotEncodeAmpersand

Especifica se a cadeia de JavaScript interna padrão rotinas de codificação codificará o e comercial ('e') caracteres.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave é false [padrão], a seqüência de JavaScript interna padrão rotinas de codificação codificará o e comercial ('e') caracteres como "\u0026", que é a forma de escape de JavaScript desse caractere. Se esse valor chave for true, as rotinas internas padrão de codificação de cadeia de caracteres de JavaScript não codificarão o caractere de E comercial.

Example:

    <appSettings>
      <add key="aspnet:JavaScriptDoNotEncodeAmpersand" value="false" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como true pode representar um risco à segurança.

aspnet:MaxConcurrentCompilations

Controla a compilação paralela de não dependências em diretórios da Web.

Type:

Int32

Default value:

1

Remarks:

Se esse valor de chave for “0 ", todos os núcleos do servidor serão usados para compilações simultâneas. Se o valor de chave for "1" [padrão], as compilações simultâneas serão desabilitadas. Se o valor de chave for "2" ou mais, a compilação simultânea de núcleo será explicitamente definida como esse valor e atuará como o valor máximo.

Os usuários com núcleos disponíveis (hospedagem não compartilhada) podem usar essa configuração para melhorar o tempo de inicialização. Se possível, defina essa configuração do aplicativo como o número de núcleos no servidor. Essa configuração é projetada especificamente para aplicativos 4.0 que desejam obter o benefício de compilações atuais; no entanto, como aplicativos 4.0, não podem definir o atributo específico de 4.5 no elemento de compilação. Além disso, esta configuração de aplicativo permite que aplicativos recusem especificamente quando são implantados em hosts que executam 4.5.

Example:

    <appSettings>
      <add key="aspnet:MaxConcurrentCompilations" value="1" />
    </appSettings>
aspnet:MaxHttpCollectionKeys

Limita o número máximo de itens que podem estar presentes em qualquer dicionário fornecido pelo cliente do objeto HttpRequest.

Type:

Int32

Default value:

1000

Remarks:

Os dicionários fornecidos pelo cliente incluem HttpRequest.Files, HttpRequest.Form, HttpRequest.Cookies, HttpRequest.QueryString, HttpRequest.Headers, HttpRequest.ServerVariables.

Example:

    <appSettings>
      <add key="aspnet:MaxHttpCollectionKeys" value="1000" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como um número grande demais pode representar um risco à segurança.

aspnet:MaxJsonDeserializerMembers

Especifica o limite do número máximo de itens que podem estar presentes em qualquer dicionário desserializado pelo tipo JavaScriptSerializer.

Type:

Int32

Default value:

1000

Remarks:

Example:

    <appSettings>
      <add key="aspnet:MaxJsonDeserializerMembers" value="1000" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como um número grande demais pode representar um risco à segurança.

aspnet:RestrictXmlControls

Especifica como o ASP.NET carregará XSLTs.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], controles XML do ASP.NET usarão XslTransform para operações XSLT. Se esse valor de chave for true, os controles do ASP.NET XML usarão XslCompiledTransform para operações XSLT.

Example:

    <appSettings>
      <add key="aspnet:RestrictXmlControls" value="false" />
    </appSettings>
aspnet:ScriptResourceAllowNonJsFiles

Especifica se o manipulador ScriptResource.axd pode atender arquivos estáticos do disco rígido se uma página do Web Forms contiver a marcação <asp:ScriptReference Path="~/the-file.ext" />.

Type:

Boolean

Default value:

false

Remarks:

O manipulador ScriptResource.axd pode servir arquivos estáticos arbitrários do disco rígido. Se esse atributo value for false [padrão], ScriptResource.axd não atenderá solicitações para arquivos a menos que o arquivo tenha uma extensão .js. Se esse atributo value for true, ScriptResource.axd atenderá solicitações para qualquer arquivo.

Example:

    <appSettings>
      <add key="aspnet:ScriptResourceAllowNonJsFiles" value="false" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como true pode representar um risco à segurança. Os clientes mal-intencionados podem ler arquivos confidenciais em seu site.

aspnet:UpdatePanelMaxScriptLength

Especifica um valor de limite de tamanho de carga JSON que o ScriptManager usará para substituir temporariamente o limite que JavaScriptSerializer permitirá ao enviar grandes cargas JSON para o cliente.

Type:

Int32

Default value:

0

Remarks:

O tipo JavaScriptSerializer tem um limite para o tamanho máximo de carga JSON que pode gerar ou consumir. Esse limite padrão é 2MB e é configurável pela propriedade MaxJsonLength. O tipo ScriptManager usa JavaScriptSerializer internamente. Se esse valor de chave for definido como um valor maior que 0, o ScriptManager substitui temporariamente o limite que o JavaScriptSerializer permitirá ao enviar grandes cargas JSON para o cliente, usando o valor de chave fornecido como o limite de tamanho de carga JSON. Se essa opção estiver definida como 0, o ScriptManager não substituirá os limites padrão do JavaScriptSerializer.

Example:

    <appSettings>
      <add key="aspnet:UpdatePanelMaxScriptLength" value="0" />
    </appSettings>
aspnet:UseHostHeaderForRequestUrl

Especifica como a propriedade Url é criada dinamicamente. Por padrão, a propriedade Url é criada dinamicamente a partir do host, da porta e do caminho fornecidos pelo servidor Web.

Type:

Boolean

Default value:

false

Remarks:

Se esse atributo value for false [padrão], a propriedade Url será criada dinamicamente a partir do host, da porta e do caminho fornecidos pelo servidor Web. Se esse atributo value for true, a propriedade Url será criada dinamicamente usando o host e a porta fornecidos pelo cabeçalho de entrada do "Host" e o caminho fornecidos pelo servidor Web.

Example:

    <appSettings>
      <add key="aspnet:UseHostHeaderForRequestUrl" value="false" />
    </appSettings>
aspnet:UseLegacyEncryption

Especifica se o ASP.NET assinará cargas que estão criptografadas.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], o ASP.NET assinará as cargas que estejam criptografadas e verificará assinaturas de criptografia antes de descriptografar essas cargas. Exemplos dessas cargas podem ser cookies de ViewState e FormsAuth, e URLs de ScriptResource.axd. Se esse valor de chave for true, o ASP.NET não assinará as cargas que estejam criptografadas e as assinaturas de criptografia dessas cargas não serão verificadas. As APIs de Encode e Decode não são afetados por essa opção; elas têm sua própria opção de compatibilidade.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyEncryption" value="false" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como true pode representar um risco à segurança.

aspnet:UseLegacyEventValidationCompatibility

Especifica o formato de serialização ASP.NET a ser usado para o campo __EVENTVALIDATION em aplicativos Web Forms.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], o campo __EVENTVALIDATION em aplicativos Web Forms será serializado usando um novo formato planejado para 4.5 e posterior. Se essa opção for true, o campo __EVENTVALIDATION usará um formato de serialização compatível com versões anteriores do ASP.NET. Essa configuração só deve ser definida como true ao migrar um aplicativo em uma implantação de farm da web para o .NET 4.5. Isso permitirá que as páginas geradas pelos servidores que executam 4.0 sejam postadas em servidores que executam 4.5, e vice-versa. Quando a migração for concluída, essa chave deve ser removida ou definida como false.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyEventValidationCompatibility" value="false" />
    </appSettings>
aspnet:UseLegacyFormsAuthenticationTicketCompatibility

Especifica se o ASP.NET irá

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], o ASP.NET serializará tickets de FormsAuth usando um formato de serialização de 4.0. Se esse valor de chave for true, o ASP.NET usará um formato de serialização mais antigo.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyFormsAuthenticationTicketCompatibility" value="false" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como true pode representar um risco à segurança.

aspnet:UseLegacyMachineKeyEncryption

Especifica se o ASP.NET assinará qualquer carga que esteja criptografada pela API do MachineKey.Encode.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for false [padrão], o ASP.NET assinará as cargas que estejam criptografadas pela API Encode e verificará assinaturas de criptografia antes de descriptografar essas cargas. Se esse valor de chave for true, o ASP.NET não assinará as cargas que estejam criptografadas pela API Encode e as assinaturas de criptografia dessas cargas não serão verificadas. ViewState, a autenticação de formulários e áreas semelhantes de gerenciamento de estado não são afetados por esse valor de chave; eles têm sua própria opção de compatibilidade.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyMachineKeyEncryption" value="false" />
    </appSettings>
Observação de cuidado Cuidado

Definir esse atributo como true pode representar um risco à segurança.

aspnet:UseTaskFriendlySynchronizationContext

Especifica como se comportam os caminhos de código assíncronos no ASP.NET 4.5.

Type:

Boolean

Default value:

false

Remarks:

Se esse valor de chave for definido como false [padrão], os caminhos de código assíncronos no ASP.NET 4.5 se comportarão como se tivessem sido feitos no ASP.NET 4.0. Se esse valor de chave for definido como true, o ASP.NET 4.5 usará caminhos de código que são otimizados para APIs de retorno de tarefas. Definir essa opção de compatibilidade é obrigatório para aplicativos habilitados para WebSockets, para usar assincronia baseada em tarefas nas páginas do Web Forms e, para determinados outros comportamentos assíncronos.

Example:

    <appSettings>
      <add key="aspnet:UseTaskFriendlySynchronizationContext" value="false" />
    </appSettings>
aspnet:MaxAcceptLanguageFallbackCount

Controla o quanto procurar um objeto CultureInfo de um cabeçalho Accept-Language de HTTP.

Type:

Int32

Default value:

3

Remarks:

Por exemplo, se você deixar o valor padrão de 3 e se um Accept-Header for recebido com “en-us, en, fr-FR, zh-CN”, o ASP.NET procurará “en-us”, “en” e “fr-FR” nessa ordem, mas se todos os três falharem, não procurará “zh-CN”.

Example:

    <appSettings>
      <add key="aspnet:MaxAcceptLanguageFallbackCount" value="3" />
    </appSettings>
aspnet:UseLegacyRequestUrlGeneration

Controls the behavior of HttpRequest.Url, which represents the current request. 

Type:

Boolean

Default value:

false

Remarks:

Se essa opção for false, o tempo de execução do ASP.NET gerará Uri que tem maior conformidade com os padrões do que as versões anteriores do ASP.NET. Se essa opção for true, o tempo de execução gerará Uri que é compatível com versões anteriores.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyRequestUrlGeneration" value="false" />
    </appSettings>
PageInspector:ServerCodeMappingSupport

Especifica se o Page Inspector está habilitado no Visual Studio.

Type:

String

Default value:

Desabilitada

Remarks:

Se o valor da chave PageInspector:ServerCodeMappingSupport for definido como Enabled no aplicativo Web, o Page Inspector será habilitado, exceto se um atributo retail do elemento deployment for definido como true na seção <system.web> do arquivo Machine.config. Se o atributo retail não estiver definido no arquivo Machine.config e o valor de chave PageInspector:ServerCodeMappingSupport também não estiver definido, o modo de depuração determinará se o Page Inspector estará habilitado.

Example:

    <appSettings>
      <add key="PageInspector:ServerCodeMappingSupport" value="Disabled" />
    </appSettings>
ValidationSettings:UnobtrusiveValidationMode

Especifica como o ASP.NET habilita globalmente os controles internos do validador para usar o JavaScript discreto para lógica de validação do lado do cliente.

Type:

UnobtrusiveValidationMode

Default value:

Nenhum

Remarks:

Se esse valor de chave for definido como “Nenhum” [padrão], o aplicativo ASP.NET usará o comportamento anterior ao 4.5 (JavaScript embutido nas páginas) para lógica de validação do lado do cliente. Se esse valor de chave for definido como “WebForms”, o ASP.NET usa os atributos de dados de HTML5 e o JavaScript de associação tardia de uma referência de script adicionada à lógica de validação do lado do cliente.

Example:

    <appSettings>
      <add key="ValidationSettings:UnobtrusiveValidationMode" value="None" />
    </appSettings>
Mostrar: