Partilhar via


Demonstra Passo a passo: Convertendo uma projeto Visual Studio .NET 2003 na Web em um projeto de aplicativo Web Web do Visual Studio

Convertendo o Web Project Visual Studio.NET 2003 em um projeto aplicativo da Web Visual Studio 2008, você pode tirar proveito dos recursos de Visual Studio 2008.Isso inclui refatoração, diagramas de classe, desenvolvimento de testes, e genéricos.O modelo de projeto de aplicativo Web Web também disponibiliza todos os recursos do ASP.NET 2.0 e posterior.Esses incluem páginas mestras, controles de dados, participação e controles de logon, gerenciamento de funções, Web Parts, personalização, navegação do site e temas.

O projeto modelo de aplicativo da Web Visual Studio 2008 coincide melhor com o modelo de projeto disponível para aplicativos 2003 Visual Studio.NET.Isso pode ser útil se você estiver convertendo um projeto Web 2003 Visual Studio.NET para Visual Studio 2008.Para obter mais informações sobre os novos recursos, consulte Novidades do ASP.NET e desenvolvimento da Web.

Observação:

Você pode criar ASP.NET Web usando os projetos de aplicativos Visual Studio ou Visual Web Developer Express Edition.

Essa explicação passo a passo explica como converter um projeto Web Visual Studio.NET 2003 existente em um projeto aplicativo da Web Visual Studio 2008 .O modelo de projeto de aplicativo Web usa o mesmo método conceitual sistema autônomo um projeto Web em Visual Studio.NET 2003.Isso inclui um arquivo de projeto para incluir ou excluir arquivos e compilação para um único assembly.Para obter mais informações, consulte Conversão de Projeto Web do Visual Studio.NET.

Observação:

Para converter um site que usa Microsoft Office FrontPage 2003 para um projeto de aplicativo Web Web, primeiro converta o site do FrontPage para um Visual Studio 2008 Projeto Web site. Em seguida, converta projeto de site Webem um projeto aplicativo da Web .Para obter mais informações, consulte Passo a Passo: Convertendo um Projeto de Site um Projeto de Aplicativo da Web no Visual Studio.

Tarefas ilustradas nesta explicação passo a passo incluem o seguinte:

  • Abrindo e verificando o Web Project 2003 Visual Studio.NET.

  • Fazendo backup do Projeto Web Visual Studio.NET 2003.

  • Convertendo o Web Project 2003 Visual Studio.NET em Visual Studio 2008.

  • Verificando o projeto aplicativo da Web no Visual Studio 2008.

  • Convertendo classes code-behind para classes parciais.

  • Examinando e resolvendo problemas de conformidade XHTML .

Pré-requisitos

A fim de concluir este explicação passo a passo, será necessário:

  • Visual Studio .NET 2003

  • Visual Studio 2008 ou Visual Studio 2005 serviço empacotar 1 (SP1) ou Visual Web Developer Express Edition

  • .NET Framework versão 2,0

Abrindo e verificando o projeto Web 2003 Visual Studio.NET.

Antes de converter um projeto, você deve verificar se ele está funcionando corretamente.Isso evitará erros durante a conversão.

Para abrir e verificar o projeto Web 2003 Visual Studio.NET.

  1. Abra Visual Studio.NET 2003.

  2. No menu Arquivo, clique em Abrir arquivo e, em seguida, digite ou navegue para o arquivo .SLN para a solução que você deseja verificar.

    Observação:

    No 2003 Visual Studio.NET, os arquivos que compõem o projeto são incluídos em um arquivo de solução (.sln).

  3. No menu Projeto, clique em Criar Solução .

  4. No menu Depurar, clique em Iniciar.

  5. Verifique se o projeto executa conforme o esperado.

Fazendo backup do Projeto Web Visual Studio.NET 2003.

É uma boa ideia fazer backup dos arquivos de solução e projeto Visual Studio.NET 2003 antes de iniciar o processo de conversão.Se ocorrerem problemas de conversão, você poderá reverter para a solução 2003 Visual Studio.NET.

Para fazer backup do projeto, você deve copiar o projeto no 2003 Visual Studio.NET.

Para fazer backup de projeto Web Visual Studio.NET 2003 antes da conversão

  1. Abra Visual Studio.NET 2003.

  2. No menu Arquivo, clique em Abrir arquivo e, em seguida, digite ou navegue para o arquivo .SLN para a solução que você deseja fazer backup.

  3. No menu Projeto , clique em Copiar projeto .

  4. Na caixa Copiar Projeto , selecione Destino Pasta Projeto .

  5. Selecione a opção Método de acesso .Você pode usar tanto FrontPage quanto Compartilhar arquivos para copiar os arquivos.

  6. Selecione a opção Incluir todos os arquivos na pasta do projeto e clique em OK .

Convertendo o projeto Web Visual Studio.NET 2003 para projeto Web Visual Studio 2008

Visual Studio 2008 converte a solução Visual Studio .NET 2003 e os arquivos de projeto para usarem o fromato Mecanismo de compilação Microsoft (MSBuild), que é o formato de arquivo de projeto em Visual Studio 2008.

Como parte do processo de conversão, Visual Studio 2008 gera um arquivo de log baseado em XML que fornece um resumo da conversão e que sinaliza problemas.Por padrão, a conversão arquivo de log é salva no mesmo diretório que o arquivo .sln.Se você tiver problemas quando você compilar o projeto convertido, você pode consultar novamente a arquivo de log de conversão.

Para converter o projeto Web para Visual Studio 2008

  1. No Visual Studio.NET 2003, feche o arquivo de solução.

  2. Abra Visual Studio 2008.

  3. No menu Arquivo, clique em Abrir arquivo e, em seguida, digite ou navegue para o arquivo .SLN para a solução que você deseja verificar.

    O Assistente de Conversão Visual Studio abre.

  4. Clique em Próxima , siga as instruções para concluir o assistente e, em seguida, clique em Concluir .

Verificando o projeto de aplicativos da Web em Visual Studio 2008

Depois que os arquivos de projeto e solução forem convertidos para o formato Visual Studio 2008, você deve verificar se o aplicativo pode criar sem erros e que ele executa conforme esperado.

Verificando o projeto de aplicativos da Web em Visual Studio 2008

  1. Em Visual Studio 2008, clique no menu Arquivo, clique Abrir arquivo e, em seguida, digite ou navegue para o arquivo .SLN para a solução que você deseja verificar.

  2. No menu Projeto, clique em Criar Solução .

  3. No menu Depurar, clique em Iniciar.

  4. Verifique se o projeto aplicativo da Web é executado conforme o esperado.

Erros e Avisos Comuns

Os tipos mais comuns de erros ou avisos que você vê durante o processo de conversão são da seguinte maneira:

  • Conflitos com nomes que foram introduzidos na caixa .NET Framework versão 2,0.

  • Avisos sobre membros obsoletos.

  • Problemas que ocorrem quando você executa o aplicativo da Web.

Para resolver conflitos de nomes, você pode remover ambiguidade qualificando totalmente nomes existentes com um namespace.Como alternativa, você pode renomear o tipos e membros conflitantes para que eles não entrem em conflito.Para obter mais informações sobre conflitos de nomeação, consulte Visão geral de migração ASP.NET 2.0 e Namespace Naming Guidelines.

Se você vir um aviso sobre membros obsoletos, a mensagem de aviso normalmente sugerirá membros alternativos para usar.Nesse caso, você pode continuar a usar os membros obsoletos.No entanto, os membros serão removidos em uma próxima versão principal da . .NET Framework.Portanto, é uma boa prática remover os membros e substituir as alternativas sugeridas.

Se você vir um erro que indica que uma listagem de diretório é negada quando você executar o aplicativo da Web,o diretório virtual do aplicativo Web do pode não permitir que seu conteúdo seja listado.Para corrigir esse problema, em Gerenciador de Soluções , clique com o botão direito do mouse na página inicial do aplicativo e, em seguida, clique em Definir como Página Inicial .Isso garante que a página correta seja chamada quando o aplicativo for executado.

Convertendo classes code-behind para classes parciais.

Em Visual Studio 2008, projeto aplicativo da Web usa as classes parciais para o código que é gerado pelo Visual Studio.Essas classes são armazenadas em um arquivo separado a partir do arquivo code-behind.Por padrão, o Visual Studio 2008 Assistente de conversão não cria um arquivo *. designer.cs ou um arquivo *. designer.vb para páginas da Web (arquivos .aspx) ou controles de usuário (arquivos .ascx).Em vez disso, o código aparenta e funciona exatamente como fazia no 2003 Visual Studio.NET.

Observação:

O Visual Studio 2008 Assistente de conversão fará o número mínimo de alterações possíveis para os arquivos de código durante o processo de conversão. Isso ajuda a criar uma conversão suave para um projeto aplicativo da Web em Visual Studio 2008.

Você pode manter o código no formato Visual Studio.NET 2003.Se você fizer isso, você deve manualmente atualização sistema autônomo declarações de campo do controle no código - behind arquivos sistema autônomo você fez no Visual Studio .NET 2003.No entanto, para usufruir a capacidade de manter as declarações de campo no código gerado, você deve atualizar as páginas e controles para usar o modelo de classe parcial.As classes parciais facilitam organizar o código gerado e o código personalizado para os arquivos code-behind.Para obter mais informações, consulte Partial (Visual Basic) e parcial (tipo) (Referência C#).

Para converter o código para usar o modelo de classe parcial

  1. Certifique-se de que o código é compilado sem erros.

  2. No Gerenciador de Soluções , clique com o botão direito do mouse no nome do projeto e clique em Converter para aplicativo Web .

    Este comando efetua iterações através de cada página e controle de usuário no projeto.Ele move todas as declarações de controle para um arquivo designer.cs ou designer.vb.Ele também adiciona declarações de manipulação de eventos para a marcação do controle de servidor nos arquivos .aspx e .ascx.

    Observação:

    Você pode Use o Converter para aplicação Web comando páginas individuais.Você pode fazer isso primeiro em algumas páginas para que você possa ver as alterações que foram feitas para cada página antes de aplicar as alterações ao aplicativo inteiro.

    Não é possível desfazer o efeito do comando Converter para aplicativo da Web .O melhor método para restaurar as alterações é restaurar a partir de um backup do projeto Visual Studio.NET 2003 e, em seguida, executar novamente a conversão Visual Studio 2008 como descrito anteriormente.

  3. Quando o processo for concluído, verificar a janela lista de tarefas para ver quais erros de conversão foram relatados.

  4. Se a lista de tarefas exibe erros, clique com o botão direito do mouse na página relevante no Gerenciador de Soluções e selecione Exibir código e Exibir código Ger arquivo para examinar o código e corrigir problemas.

    Observação:

    Erros e avisos que aparecem na Lista de tarefas janela persista entre Visual Studio sessões. Após você ter corrigido erros listados na janela, você pode limpar itens da lista de tarefas.

  5. Recompile o projeto e certifique-se que ele foi compilado sem erros.

A partir deste ponto, ao adicionar novas páginas para o projeto Web, por padrão as páginas usarão o modelo de classe parcial.Para obter mais informações, consulte Visão geral de migração ASP.NET 2.0.

Examinando e resolvendo problemas de conformidade XHTML .

Por padrão, Visual Studio 2008 gera e valida marcação compatível com XHTML.Isso ajuda você a criar aplicativos da Web que são compatíveis com padrões e minimizar problemas com processamento de navegador específico.Por padrão, Visual Studio.NET 2003 não gera marcação compatível com XHTML.Portanto, após converter o aplicativo Web para Visual Studio 2008, talvez você veja problemas de validação e de processamento com páginas que foram criadas no 2003 Visual Studio.NET.

Observação:

Erros de validação são apenas informativos e são sinalizados como avisos.Erros de validação não impedem a execução de uma página.

Se você deseja ver erros de validação HTML como você fez no Visual Studio.NET 2003, alterne a configuração de validação HTML XHTML Transitional para Internet Explorer 6.0.Internet Explorer 6.0 foi a configuração padrão no 2003 Visual Studio.NET para validação de HTML.Para obter mais informações, consulte Como: Selecionar esquemas de validação para edição de HTML no Visual Web Developer.

Também é possível adicionar a seção a seguir ao arquivo Web.config do projeto, que faz com que o ASP.NET possa processar marcações legadas (compatível com não XHTML) de controles de servidor:

<system.Web>
  <xhtmlConformance mode="Legacy" />
</system.Web>

Isso evita as pequenas diferenças de processamento que você poderá ver entre páginas exibidas usando o ASP.NET 1.1 e ASP.NET 2.0.Observe que você deve usar a alteração do modo xhtmlConformance somente para resolver quaisquer problemas de conversão.Enquanto o projeto aplicativo Web estiver sendo executado corretamente, remova a configuração de herança.Para obter mais informações, consulte O ASP.NET e o XHTML e Visão geral de migração ASP.NET 2.0.

Consulte também

Tarefas

Como: Atualizar projetos criados no Visual Studio .NET 2002 ou 2003

Conceitos

Conversão de Projeto Web do Visual Studio.NET

Visão geral de migração ASP.NET 2.0

Modelo de código de página Web do ASP.NET

O ASP.NET e o XHTML

Referência

Partial (Visual Basic)

parcial (tipo) (Referência C#)

Parcial classes e métodos (Guia de programação C#)

Assistente de conversão do Visual Studio

Outros recursos

Namespace Naming Guidelines