Conversão de Configurações do Projeto da Web

  • Artigo

Como o Visual Studio não mantém arquivos de projeto para desenvolvimento na Web, o processo de conversão deve transferir configurações de projeto e de solução relevantes em um formato Visual Studio.Por exemplo, o processo de conversão move algumas configurações do projeto para o arquivo Web.config, que no Microsoft Visual Studio 2005, é expandido para armazenar mais informações do que em versões anteriores do Visual Studio.NET.

Muitas configurações mantidas no Visual Studio .NET não são aplicáveis ao Visual Studio 2005, portanto elas não são convertidas.Por exemplo, configurações do projeto para o modo de acesso da web (compartilhamento de arquivo ou o FrontPage) e para padrões de Designer não são aplicadas no Visual Studio, então eles não são convertidos.Configurações do projeto que estão definidas para valores padrão não são convertidas também; isto é, o Visual Studio não emite uma nova configuração com o valor padrão dentro dela.

Projetos com várias configurações

Se um projeto contiver várias configurações (compilação de depuração, compilação de versão e assim por diante), a conversão segue esta lógica:

  • Se o projeto contém apenas configurações Debug e Release, então, a configuração do Debug é convertida no Visual Studio 2005.

  • Se existirem configurações adicionais, o Visual Studio emitirá solicitação de definição de configuração que deve ser convertida no Visual Studio 2005.

Referências

Referências a assemblies na pasta Bin do projeto não precisam ser convertidas; web sites do Visual Studio Web pegam automaticamente as referências ao código na pasta Bin.Se o projeto contém uma referência para um armazenamento em cache de assembly global, a referência é movida para o arquivo Web.config no formato a seguir.

<compilation>
  <assemblies>
    <add assembly="System.Messaging" />
  </assemblies>
</compilation>

Referências assembly não são convertidas se o assembly já tiver sido citado, por padrão, no ASP.NET (por exemplo, System.Drawing).

No Visual Studio.NET, os conjuntos de módulos (assemblies) referenciados (por exemplo, conjuntos que foram referenciados fora da solução em que o projeto da Web está localizado) poderia ter a propriedade CopyLocal definida como true, que iria atualizar automaticamente o assembly referenciado.No Visual Studio 2005, esse comportamento é substituído ao criar um arquivo de atualização na pasta Bin.O arquivo de atualização contém o caminho para o conjunto de módulos (assembly) referenciado externo e tem a extensão .refresh acrescentado ao nome do conjunto de módulos (assembly).

As referências Web XML são convertidas ao copiar o arquivo .wsdl para o diretório App_WebReferences.O proxy serviço Web e os arquivos de mapeamento de referências não são necessários no Visual Studio 2005.

Conversão de Configurações Comuns

A tabela a seguir lista as configurações Common Properties do projeto e como elas são tratadas pelo processo de conversão do Visual Studio.

Observação:

Você pode ver os valores atuais para essas configurações no Visual Studio.No Solution Explorer, clique com o botão direito do mouse em projeto, clique em Properties e clique em Common Properties.

Configuração

Lógica de conversão

Geral

Configurações não são convertidas.

Configurações da Web

Configurações não são convertidas.

Padrões do Designer

Configurações não são convertidas.

Caminho de referências

Configurações não são convertidas.

Build (projetos clientes do Visual Basic)

  • Opção Explicit

    Se definida como false, esta configuração será movida para o arquivo Web.config:

    <compilation explicit="false">

  • Opção estrita

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compilation strict="true" />

  • Opção Compare

    Se definida como Text, esta configuração será movida para o arquivo Web.config:

    <compiler language="vb"

    compilerOptions="optioncompare:text" />

Imports (projetos clientes do Visual Basic)

Configurações de importação que não são importadas por padrão no ASP.NET são movidas para o arquivo Web.config:

<pages>

<namespaces>

<add namespace="Namespace" />

</namespaces>

</pages>

A conversão afeta somente as configurações de importação para páginas da Web ASP.NET.Para classes no diretório App_Code, você deve adicionar configurações de importação manualmente.

Definições de Configuração de Conversão

Opções de configuração para um projeto diferem ligeiramente, dependendo de qual linguagem de programação o projeto usa.As tabelas a seguir listam como definições de configuração são tratadas pelo processo de conversão pelo Visual Studio, quebradas pela linguagem.

Observação:

Você pode ver os valores atuais para essas configurações no Visual Studio.No Solution Explorer, clique com o botão direito do mouse no projeto, clique em Propertiese, em seguida, clique em Configuration Properties.

Definições de Configuração — Todas as Linguagens

A tabela a seguir lista as configurações Configuration do projeto, que aparecem em todos os tipos de projeto, e descreve como elas são tratadas pelo processo de conversão do Visual Studio.

Configuração

Lógica de conversão

Depuração

  • Ativar depuração ASP

    Configuração não é convertida.

  • Ativar depuração ASP.NET

    Configuração não é convertida.

  • Ativar depuração não gerenciada

    Configuração é convertida como estiver.

  • Ativar depuração SQL

    Configuração é convertida como estiver.

  • Configurações Start Action

    Configurações são movidas para um cache do cliente por usuário.

  • Argumentos da linha de comando

    Configuração é convertida como estiver.

  • Diretório de trabalho

    Configuração é convertida como estiver.

  • Sempre usar o Internet Explorer

    Configuração não é convertida.

  • Ativar depuração remota

    Configuração não é convertida.

  • Máquina de depuração remota

    Configuração não é convertida.

Definições de Configuração — Visual Basic .NET

A tabela a seguir lista as configurações Configuration do projeto que aparecem em um projeto do Visual Basic .NET e descreve como elas são tratadas pelo processo de conversão do Visual Studio.

Configuração

Lógica de conversão

Criar

  • Caminho de saída

    Configuração não é convertida.

  • Gerar Informações sobre depuração

    Configuração é movida para o arquivo Web.config:

    <compilation debug="true|false" />

  • Registrador para COM Interop

    Configuração não é convertida.

  • Enable build warnings (projetos clientes do Visual Basic)

    Configuração não é convertida.Os avisos de compilação estão sempre habilitados no Visual Studio.NET.

  • Treat compiler warnings as errors (projetos clientes do Visual Basic)

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="vb"

    compilerOptions="warnaserror+" />

  • Define DEBUG constant (projetos clientes do Visual Basic)

    Configuração é movida para o arquivo Web.config:

    <compiler

    language="vb"

    compilerOptions="define:Debug" />

  • Define TRACE constant (projetos clientes do Visual Basic)

    Configuração é movida para o arquivo Web.config:

    <compiler

    language="vb"

    compilerOptions="define:Trace" />

  • Custom constants (projetos clientes do Visual Basic)

    Configuração é movida para o arquivo Web.config:

    <compiler

    language="vb"

    compilerOptions="define:<list>" />

  • A Documentação XML

    Se definida, esta configuração será movida para o arquivo Web.config:

    <compiler language="c#"

    compilerOptions="doc:<filepath>" />

  • Constantes de compilação condicional

    Configuração é movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="d:<symbols>" />

  • Optimize Code

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="o" />

  • Check for Arithmetic Overflow/Underflow

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="checked+" />

  • Allow Unsafe Code Blocks

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="unsafe+" />

  • Warning Level

    Se não definida como 4, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="w:<level>" />

  • Treat Warnings As Errors

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler language="c#"

    compilerOptions="warnaserror+" />

  • Suppress Specific Warnings

    Se definida, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="nowarn:<warning list>" />

Optimizations (projetos de cliente do Visual Basic)

  • Remove integer overflow checks

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="vb"

    compilerOptions="removeintchecks+" />

  • Enabled optimizations

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="vb"

    compilerOptions="optimize+" />

  • Construção incremental ativada

    Configuração não é convertida.

  • Endereço DLL básico

    Configuração não é convertida.

Definição de Configuração — C#

A tabela a seguir lista as configurações Configuration do projeto que aparecem em um projeto C#, e descreve como elas são tratadas pelo processo de conversão do Visual Studio.

Configuração

Lógica de conversão

Criar

  • Constantes de compilação condicional

    Configuração é movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="d:<symbols>" />

  • Optimize Code

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="o" />

  • Check for Arithmetic Overflow/Underflow

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="checked+" />

  • Allow Unsafe Code Blocks

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="unsafe+" />

  • Warning Level

    Se não definida como 4, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="w:<level>" />

  • Treat Warnings As Errors

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler language="c#"

    compilerOptions="warnaserror+" />

  • Suppress Specific Warnings

    Se definida, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="nowarn:<warning list>" />

  • Caminho de saída

    Configuração não é convertida.

  • A Documentação XML

    Se definida, esta configuração será movida para o arquivo Web.config:

    <compiler language="c#"

    compilerOptions="doc:<filepath>" />

  • Gerar Informações sobre depuração

    Configuração é movida para o arquivo Web.config:

    <compilation debug="true|false" />

  • Registrador para COM Interop

    Configuração não é convertida.

Avançado

  • Incremental Build

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="incr+" />

  • Base Address

    Configuração não é convertida.

  • Alinhamento de arquivo

    Se não definida como 4096, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="filealign:<n>" />

  • Do not Use Mscorlib

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="c#"

    compilerOptions="nostdlib+" />

Definição de Configuração — J#

A tabela a seguir lista as configurações Configuration do projeto que aparecem em um projeto Microsoft J# .NET, e descreve como elas são tratadas pelo processo de conversão do Visual Studio.

Configuração

Lógica de conversão

Criar

  • Constantes de compilação condicional

    Configuração é movida para o arquivo Web.config:

    <compiler

    language="j#"

    compilerOptions="d:<symbols>" />

  • Optimize Code

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="j#"

    compilerOptions="o" />

  • Warning Level

    Se não definida como 4, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="j#"

    compilerOptions="w:<level>" />

  • Treat Warnings As Errors

    Se definida como true, esta configuração será movida para o arquivo Web.config:

    <compiler language="j#"

    compilerOptions="warnaserror+" />

  • Suppress Specific Warnings

    Se definida, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="j#"

    compilerOptions="nowarn:<warning list>" />

  • Caminho de saída

    Configuração não é convertida.

  • Gerar Informações sobre depuração

    Configuração é movida para o arquivo Web.config:

    <compilation debug="true|false" />

  • Registrador para COM Interop

    Configuração não é convertida.

Avançado

  • Base Address

    Configuração não é convertida.

  • Additional Options

    Se definida, esta configuração será movida para o arquivo Web.config:

    <compiler

    language="j#"

    compilerOptions="<list of options>" />

Consulte também

Conceitos

Conversão de Projeto Web do Visual Studio.NET

Conversão de arquivos de projeto e solução Web