Conversão de Projeto Web do Visual Studio.NET

Artigo
10/15/2014

Microsoft Visual Studio 2005 gerencia projetos site da Web e arquivos diferentemente do Visual Studio .NET 2002 e Visual Studio .NET 2003 (que são coletivamente chamados Visual Studio .NET no restante deste tópico).Como resultado, quando você desejar usar Visual Studio 2005 para trabalhar com um projeto que foi criado em Visual Studio .NET, o projeto será convertido em um projeto de aplicativo da Web.O processo ocorre automaticamente quando você abre um projeto Visual Studio .NET no Visual Studio 2005; o Assistente para conversão converterá o aplicativo da Web e minimizará a quantidade de edição manual que é necessária para concluir a conversão.Este tópico descreve o processo de conversão e especifica as alterações que são feitas nos arquivos Visual Studio .NET.Para obter mais informações sobre projetos de aplicativo da Web, consulte Visão geral de Projetos de Aplicativos Web.

O objetivo geral do processo de conversão é permitir que você abra um projeto Visual Studio .NET no Visual Studio 2005, convertê-lo automaticamente, e executá-lo sem nenhuma alteração na funcionalidade.O processo de conversão é unidirecional — depois de converter um projeto para Visual Studio 2005, não será possível trabalhar com ele em Visual Studio .NET.Embora Visual Studio 2005 faça alterações para os arquivos em um projeto, você pode fazer cópias de backup dos arquivos originais.Você ainda poderá abrir arquivos do Visual Studio 2005 no Visual Studio .NET como arquivos autônomos (sem certos recursos, como o IntelliSense), mas o projeto geral terá sido alterado.Se necessário, você pode restaurar o projeto Visual Studio dos arquivos de backup.

Observação de segurança:
Antes de converter um projeto existente em Visual Studio 2005, examine todos os arquivos existentes, especialmente se você não for a única pessoa que modificou o projeto.Procure arquivos desconhecidos.Isso ajuda a proteger contra a importação de código mal-intencionado para o Visual Studio.Em geral, é recomendável que você execute Visual Studio 2005 como um usuário normal e não como um administrador a menos que você precise executar tarefas administrativas.

Antes de converter um projeto existente em Visual Studio 2005, examine todos os arquivos existentes, especialmente se você não for a única pessoa que modificou o projeto.Procure arquivos desconhecidos.Isso ajuda a proteger contra a importação de código mal-intencionado para o Visual Studio.Em geral, é recomendável que você execute Visual Studio 2005 como um usuário normal e não como um administrador a menos que você precise executar tarefas administrativas.

Este tópico inclui informações sobre os seguintes aspectos de converter projetos da Web no Visual Studio 2005:

Processo de conversão Visual Studio 2005
Soluções e Projetos:
Conversão de Configurações do Projeto
Convertendo configurações específicas
Componentes de dados
Módulos de código
Serviços da Web
Conversão e de controle do código fonte

Processo de conversão Visual Studio 2005

A lista a seguir resume o processo de conversão básico de um projeto da Web do Visual Studio .NET para Visual Studio 2005:

No Visual Studio 2005, abra um site da Web já existente.Você pode abrir qualquer um dos seguintes arquivos e diretórios:
- Um arquivo de solução (.sln)
- Um arquivo de projeto (.vbproj, .csproj ou .vjp)
- O diretório raiz do site da Web

Se for encontrado um arquivo de projeto, então o Visual Studio 2005 invocará o Assistente de conversão para converter o projeto da Web.

Observação:
Os projetos da Web não mais necessitam de um arquivo de projeto no Visual Studio 2005; todos os arquivos localizados na pasta projeto da Web são considerados parte da projeto da Web.

Para obter detalhes sobre as etapas no assistente de conversão, consulte Como: Converter um projeto do Visual Studio .NET para o Visual Studio 2005.

O Visual Studio 2005 converte o aplicativo da Web do uso do ASP.NET versão 1.x para o ASP.NET versão 2.0.Por exemplo, o atributo CodeBehind em páginas da Web ASP.NET e controles de usuário será alterado para o novo atributo CodeFile.Se um arquivo é modificado, as permissões de arquivo original não são preservadas — o novo arquivo terá permissões de leitura/gravação, que são dadas aos usuários.Para obter detalhes sobre as alterações feitas aos arquivos, consulte Conversão de arquivos de projeto e solução Web.
Arquivos de classe autônomos são movidos para o diretório App_Code.
Outros tipos de arquivos não são utilizados.Isso inclui elementos gráficos, arquivos HTML e assim por diante.Além disso, o processo de migração ignora arquivos que estejam fora do aplicativo.Isso ajuda a impedir que usuários mal-intencionados acessem arquivos que estão fora do aplicativo usando caminhos relativos em um arquivo de projeto.
Um relatório denominado conversionreport.txt é criado e armazenado na diretório raiz do projeto da Web convertido.Este arquivo de relatório lista todas as alterações que foram feitas para o projeto da Web, e ele pode conter comentários informativos, avisos e erros foram encontrados durante a conversão.Se você selecionar a opção do Assistente de conversão para mostrar o log de conversões depois que o assistente for concluído, você verá um relatório de conversão no Visual Studio 2005.Para obter mais informações sobre o formato deste relatório, consulte Formato do Relatório de Migração por Conversão.

Observação:
Se o seu projeto utiliza controle do código-fonte, os arquivos de projeto da Web não poderão estar sob o controle do código-fonte depois que eles sejam convertidos para Visual Studio 2005.

Soluções e Projetos:

Se você abrir um arquivo de solução no Visual Studio 2005, Visual Studio inspeciona o conteúdo do arquivo .sln para determinar os tipos de projetos que ele contém.Visual Web Developer irá converter somente aplicativos da Web (Páginas da Web e serviços da Web).Se você abrir um arquivo de solução que contém outros tipos de projetos, como projetos Windows Forms ou aplicativos de console, somente os projetos da Web serão abertos e convertidos.

Se você abrir um arquivo de projeto, Visual Studio 2005 converte os arquivos referenciados pelo projeto.Nenhuma tentativa é feita para converter arquivos que estão no mesmo diretório que os arquivos de projeto que não fazem parte do projeto.Isso pode levar à geração de erros.Por exemplo, se você tiver um arquivo denominado Page1.aspx e um arquivo code-behind chamado Page1.aspx.cs que está na pasta mas não está incluído no arquivo de projeto, então o Assistente para conversão não converterá o arquivo.Quando você compila, você terá erros de compilação porque os arquivos Page1.aspx e Page1.aspx.cs serão ambos considerados parte do aplicativo da Web convertido.

Se o projeto contém diretórios que têm nomes reservados em Visual Studio 2005, tais como App_Data ou App_GlobalResources, Visual Studio 2005 acrescentará "_old" para os nomes de diretório existente (por exemplo, App_Data_old).Para resolver quaisquer referências desfeitas que isso pode causar, você deve alterar manualmente o código para se referir ao novo diretório ou mover o código para os diretórios reservados, como App_Data ou App_GlobalResources.Para obter mais informações, consulte Pastas de código compartilhado em sites da Web ASP.NET.

Conversão de Configurações do Projeto

Porque o Visual Studio 2005 não mantém configurações em arquivos de projeto, as configurações para projetos Visual Studio .NET ou são convertidas para o arquivo web.config, ou eles não são convertidos se as configurações não se aplicam ao Visual Studio 2005 como faziam em Visual Studio .NET.

Para obter detalhes, consulte:Conversão de Configurações do Projeto da Web.

Convertendo configurações específicas

Se o projeto de origem contiver uma configuração de compilação personalizada, o processo de conversão solicita que você selecione qual configuração que você deseja converter.Sua escolha determina quais configurações do projeto serão usadas durante a conversão para configurar o site da Web no seu novo formato.

Se o projeto de origem contiver apenas configurações de compilação padrões (Depurar e Liberar), o processo de conversão usa as definições na configuração de depuração.

Componentes de dados

O modelo para adicionar acesso a dados a páginas da Web foi alterado no Visual Studio 2005.Embora o Visual Studio 2005 ainda use componentes do ADO.NET para o acesso a dados, Visual Studio 2005 páginas controle acessem dados usando o s controle fonte de dados, que encapsulam os objetos de conexão de dados, objetos de comando de dados e leitores de dados ou conjuntos de dados.Para obter detalhes, consulte Visão geral sobre controles fonte de dados e Visão geral de expressões de ligação de dados.

O modelo do Visual Studio .NET de trabalhar com instâncias explícitas de conexões de dados, comandos de dados e conjuntos de dados ainda é suportado no Visual Studio 2005.Quando o Visual Studio 2005 converte páginas ou arquivos que envolvam o acesso a dados, objetos de dados existentes são convertidas em intacta e eles continuem funcionando no Visual Studio 2005 sistema autônomo faziam no Visual Studio. NET.No entanto, não será possível trabalhar com esses componentes de dados no designer de Página da Web do Visual Studio 2005 (modo de design) porque o designer não oferece suporte para esses objetos.Você ainda pode trabalhar com eles em Modo de exibição Source.

Conjuntos de Dados

Durante a conversão, o Visual Studio 2005 converte o esquema (um arquivo .xsd) de uma conjunto de dados tipado e o armazena no diretório App_Code.O arquivo .vb ou. cs que representa a classe do conjunto de dados (como gerado pelo Visual Studio) não é convertido porque o site pode fazer referência ao arquivo .xsd automaticamente.

Módulos de código

Módulos de código independentes (arquivos .vb e .cs) são movidos como são para o diretório App_Code.(Isso não se aplica a arquivos .vb e .cs que estão associados com páginas da Web ou outros arquivos ASP.NET.) Quaisquer declarações de membros que estejam marcadas como Friend ou Internal são alterados para Public.

Para arquivos .vb, o processo de conversão adiciona uma instrução Namespace apontando para o diretório raiz da projeto da Web.Além disso, o processo de conversão adiciona as classes que já não foram importadas automaticamente pelo ASP.NET ao atributo compilerOptions do elemento do compilador.

Serviços da Web

Os serviços da Web são convertidos essencialmente no mesmo formato que eles têm no Visual Studio .NET.O arquivo de classe para um serviço Web (o arquivo .asmx.vb ou .asmx.cs) é movido para o diretório App_Code.Quaisquer membros que estejam marcadas como Friend ou Internal são alterados para Public.The CodeBehind attribute of the @ Page directive in the .asmx file is updated to point to the new location of the code.

Nos serviços de Web do Visual Basic, uma declaração Namespace é adicionada ao arquivo de classe que é definido pelo namespace raiz no projeto da Web.O processo de conversão também adiciona uma instrução Imports ao arquivo Visual Basic para definir todas as importações para o serviço Web que ainda não foram importados por padrão pelo ASP.NET.