Direcionamento do .NET Framework para sites da Web
O recurso de multiplataforma do Visual Studio 2008 permite que você especifique a versão .NET Framework que você deseja que o site da Web ou serviço Web direcione.Isso permite que você use Visual Studio 2008 Para modificar novos e existentes Visual Studio 2008 Projetos da Web sem criar novas dependências de assembly acidentalmente em seus projetos. Visual Studio 2008 permite que você crie um Web site que pode ser implantado para o .NET Framework 2,0, .NET Framework versão 3,0, ou .NET Framework versão 3,5 Service Pack 1. Ele faz isso, certificando-se que o projeto usa apenas a funcionalidade que está disponível na versão do .NET Framework que você especificar para o projeto.
Este tópico contém informações sobre o seguinte:
Diferenças do projeto na definição alvo de um .NET Framework
Cenários
Multiplataforma no Visual Studio 2008 permite que você direcione um site da Web para uma versão específica do .NET Framework.Por exemplo, talvez você queira criar uma aplicativo Web ASP.NET que usa os recursos de segurança suportados pela Windows Communication Foundation (WCF).Se o aplicativo não precisar de suporte para LINQ (consulta integrada à linguagem), você pode direcionar o .NET Framework versão 3,0.
Voltar ao topo
Recursos de multiplataforma
Os recursos de multiplataforma do Visual Studio 2008 incluem o seguinte:
Você pode selecionar a versão do .NET Framework quando estiver criando um novo site.
Visual Studio pode detectar a versão do .NET Framework quando você abre um site da Web.
Quando Visual Studio detecta que um site da Web usa o .NET Framework versão 2,0, Visual Studio lhe dá a opção de direcionar ao .NET Framework versão 3,5 Service Pack 1.
Visual Studio filtra os recursos que não se aplicam à atual versão de destino do .NET Framework.Isso inclui opções de menu, objetos ToolBox, processos de compilação e referências do conjunto de módulos (assembly).
Você pode usar as propriedades do projeto para selecionar uma versão .NET Framework de destino.
Bibliotecas do .NET Framework
Visual Studio permite que você direcione das seguintes versões do .NET Framework:
.NET Framework versão 2.0 A versão do .NET Framework que é incluída no Microsoft Visual Studio 2005.
.NET Framework versão 3.0A versão do .NET Framework que é incluída com o sistema operacional .Esta versão .NET Framework inclui suporte para Windows Presentation Foundation (WPF), Windows Communication Foundation (WCF), Windows CardSpace e Windows Workflow Foundation.
.NET Framework versão 3.5 A versão .NET Framework que é incluída como o padrão para Visual Studio.Esta versão .NET Framework inclui suporte para AJAX ASP.NET e Language-Integrated Query (LINQ).
Voltar ao topo
Segundo plano
Visual Studio 2008 permite que você selecionar várias versões dos .NET Framework de um ambiente de desenvolvimento único. Visual Studio 2005 e versões anteriores direcionadas a uma única versão do .NET Framework. Os desenvolvedores que desejavam gravar aplicativos para versões diferentes do .NET Framework faziam isso, executando versões do Visual Studio lado a lado.Dependências de tempo de execução e compatibilidade com versões anteriores eram as principais considerações relacionadas à multiplataforma.
Em Visual Studio 2008, você pode abrir um site da Web Visual Studio 2005 sem que quaisquer alterações sejam feitas no seu código.No entanto, o arquivo de projeto para o Web Site será atualizado.Por padrão, projetos Visual Studio 2005 continuarão a direcionar o .NET Framework 2,0.No entanto, você pode alternar a versão do framework de destino de um projeto existente para tirar proveito dos novos recursos em uma versão posterior do .NET Framework.
A funcionalidade .NET Framework mais recente está incluída em novos conjuntos de módulos (assemblies).Conjuntos de módulos para versões anteriores do .NET Framework não são alterados.
Criar um novo site da Web
Quando você cria um novo site, você pode especificar a versão do .NET Framework para direcionar para seu projeto.Projetos Visual Studio Novos automaticamente direcionam a versão mais recente do .NET Framework.
O procedimento a seguir descreve como criar um novo site que tem como alvo uma versão .NET Framework especificada.
Criar um novo site e especificar o destino do .NET Framework
Em Visual Studio, no menu Arquivo, clique em Novo Web Site.
A caixa de diálogo New Web Site é exibida.
Na lista de versões do framework, selecione a versão .NET Framework que você deseja que o projeto direcione.
A lista de modelos exibidos na caixa de diálogo é filtrada com base no framework que você seleciona.
Em Modelos instalados do Visual Studio, selecione um tipo de site, como Site da Web ASP.NET.
Clique em OK.
Abrir um site da Web existente do Visual Studio 2005
Visual Studio 2008 permite que você abra projetos ou sites que foram criados em versões anteriores do Visual Studio sem atualizar os projetos para uma versão mais recente do .NET Framework.Você pode editar, compilar, criar, depurar e salvar projetos Visual Studio 2005.
Você pode abrir um projeto existente Visual Studio 2005 sem direcionar uma versão .NET Framework mais recente.Na primeira vez que o aplicativo da Web é aberto no Visual Studio 2008, será solicitado que você direcione o site para .NET Framework versão 3,5 Service Pack 1.Se você não deseja alterar o framework de destino, clique em Não.
.gif "Observação") Observação: |
|---|
Quando você abre um site remoto, Visual Studio 2008 não tenta filtrar as versões disponíveis de acordo com as versões .NET Framework que estão instaladas no servidor remoto. |
Atualizando ou fazendo downgrade da versão de destino do .NET Framework para um site existente
O procedimento a seguir descreve como alterar a versão do .NET Framework de um projeto existente para direcionar uma versão mais antiga ou mais recente.
Atualizar para uma versão mais recente do .NET Framework permite que você se beneficie dos novos recursos.Fazer downgrade de um aplicativo Web para uma versão do .NET Framework diferente permite que você direcione a versão do .NET Framework instalada em um servidor Web diferente.
Se você estiver fazendo downgrade de um projeto, você deve certificar-se que o projeto trabalha com a versão mais antiga do .NET Framework.Isso geralmente requer que você faça alterações no projeto manualmente.
| Observação: |
|---|
Além dos diferentes recursos que estão disponíveis para cada versão do .NET Framework, as diferenças principais quando você altera a versão do .NET Framework de um aplicativo Web estão no arquivo Web.config. |
Atualizar ou fazer downgrade da versão do .NET Framework para um site da Web
Em Visual Studio 2008, abra o site que você deseja atualizar ou fazer downgrade.
No Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e, em seguida, clique em Páginas de Propriedades.
Observação:Para projetos de aplicativos Web, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e, em seguida, clique em Propriedades.
Na página Propriedades de Projeto, clique na guia Construir.
Observação:Para projetos de aplicativos Web que usam C#, clique na guia Aplicativo da página Propriedades de Projeto.Para projetos de aplicativos Web que usam Visual Basic, clique na guia Compilador da página Propriedades de Projeto e clique em Configurações avançadas do compilador.
Na lista suspensa .NET Framework, selecione um número de versão para direcionar.
Observação:Para projetos de aplicativos Web, o projeto é descarregado e recarregado, em seguida, em Visual Studio.
Se você tiver feito downgrade de um projeto, faça o seguinte:
Remova manualmente referências a componentes que não são parte da versão .NET Framework direcionada.
Observação:Você pode ver erros de referência no seu código por causa das referências do conjunto de módulos (assembly) que não funcionem com a versão mais antiga do .NET Framework.Nesse caso, você deve substituir manualmente quaisquer referências ausentes do conjunto de módulos (assembly).
Se o projeto contém referências de serviço, remova-as clicando com o botão direito do mouse na referência de serviço e, em seguida, clicando em Remover.
Referências de Assembly
Visual Studio lhe ajuda a adicionar referências a projetos Web sem atualizar automaticamente para uma versão do .NET Framework diferente.
Quando você adiciona uma referência a um conjunto de módulos (assembly), a caixa de diálogo Adicionar referência exibe somente conjuntos de módulos (assemblies) do sistema que pertençam à versão do .NET Framework direcionada.Isso impede que você, inadvertidamente, adicione referências aos conjuntos de módulos (assemblies) que não estão no framework de destino.
| Observação: |
|---|
Você pode editar manualmente o arquivo do seu projeto para incluir referências que pertençam a um destino .NET Framework que seja posterior a aquele do projeto atual.No entanto, isso gerará avisos em tempo de compilação. |
Você pode adicionar uma referência do conjunto de módulos (assembly) do usuário ao seu projeto que, por sua vez, referencia assemblies de sistema que não fazem parte do framework de destino.Nesse caso, Visual Studio exibe um aviso.Se você ignorar este aviso, ele exibe novamente em tempo de compilação.
Voltar ao topo
Diferenças do projeto na definição de uma versão do .NET Framework
Esta seção foca nas diferenças entre projetos Web que usam versões diferentes do .NET Framework.Diferenças incluem compilação, suporte ao conjunto de módulos (assembly) e suporte a recursos.Alguns recursos em Visual Studio não incluem suporte para multiplataforma, como o IntelliSense e implantação.
Para novos sites, a versão do .NET Framework que você selecionar determina o seguinte:
Os conjuntos de módulos (assemblies) que são referenciados por padrão.
Os namespaces que são incluídos por padrão em páginas Web ASP.NET e arquivos de classe.
A versão do compilador que é usada pelo ASP.NET em tempo de execução e em tempo de design para compilação dinâmica.
As opções que podem ser selecionadas no Visual Studio, como objetos, novos itens, referências do conjunto de módulos (assembly), referências da Web e referências de serviço.
Quando você abre um existente Web site Visual Studio tenta detectar o .NET Framework versão e conjunto de destino de projetos .NET Framework versão. Visual Studio Determina o .NET Framework versão usando os seguintes critérios:
Se as referências assemblies .NET Framework 3,0 existirem, o projeto Web direciona pelo menos a .NET Framework 3,0.(Dependendo de outras condições, ele pode direcionar uma versão posterior.)
Se uma seção compilers no arquivo Web.config é mapeada para uma versão do compilador de "v3.5" para C# ou Visual Basic, o site direciona o .NET Framework 3,5.
Se houver referências a assemblies .NET Framework 3,5, o site direciona o .NET Framework 3,5.
Se o site não atender às condições anteriores, o site direciona o .NET Framework versão 2,0.
Observação:Se o projeto foi aberto anteriormente ou foi criado pelo Visual Studio, o número da versão de destino já será armazenado no projeto.Nesse caso, Visual Studio usa o número de versão armazenado.Ele não tenta detectar uma incompatibilidade entre o número de versão armazenado e a versão detectada a partir das referências e compiladores.
Selecionando o modelo de um projeto
Visual Studio exibe somente os modelos de projeto que se aplicam à versão .NET Framework direcionada no momento.Quando você cria um novo site da Web, Visual Studio automaticamente direciona o número de versão mais alto do .NET Framework para fornecer acesso aos recursos mais recentes.Como alternativa, você pode selecionar uma versão de destino ao criar o projeto.
O conteúdo padrão do arquivo Web.config para um novo site é baseado na versão do .NET Framework selecionada.Os assemblies padrão referenciados são especificados na seção assemblies, e a versão do compilador é especificada na seção compilers.
Adicionando objetos da caixa de ferramentas
Visual Studio desativa os itens na Caixa de Ferramentas que não se aplicam à versão de destino atual de .NET Framework.O comportamento multiplataforma da Caixa de Ferramentas parte do pressuposto de que componentes para uma versão específica do .NET Framework podem ser usados em projetos para essa versão ou versões posteriores.Por exemplo, controles .NET Framework 2,0 podem ser usados em .NET Framework 2,0, .NET Framework versão 3,0, ou .NET Framework versão 3,5 Service Pack 1.
Adicionando novos itens
Visual Studio filtra itens que são exibidos na caixa de diálogo Adicionar novo item com base na versão de destino atual de .NET Framework.
| Observação: |
|---|
Se você adicionar um item existente a um projeto, Visual Studio não verifica que as referências e importações para esse item correspondem à versão de destino atual de .NET Framework.Nenhum aviso é gerado.No entanto, se essas referências não puderem ser resolvidas no projeto, você verá um erro quando criar e executar o projeto. |
Adicionando Referências a Assemblies.
Quando você abrir a caixa de diálogo Adicionar Referência, Visual Studio verifica a versão atualmente direcionada da versão .NET Framework e enumera apenas os assemblies que estão disponíveis para essa versão.Assemblies que são para um framework de destino mais recente são exibidos mas estão desativados.
O título da caixa de diálogo Adicionar Referência inclui a versão de destino .NET Framework atual.Como a caixa de diálogo mostra a versão do Framework de cada assembly, você pode determinar qual versão do .NET Framework é necessária para adicionar a referência.A caixa de diálogo Adicionar referência também exibe informações sobre o assembly como uma dica de ferramenta quando você mantém o ponteiro do mouse em um assembly não disponível.
| Observação: |
|---|
Se você adicionar uma referência do sistema manualmente (sem usar a caixa de diálogo Adicionar referência), Visual Studio não verifica a referência.Você pode ver avisos em tempo de design ou em tempo de compilação que a referência do assembly não faz parte da atual versão de destino do .NET Framework. |
Adicionando referências de serviço
A caixa de diálogo Adicionar Referência de Serviço está disponível somente em sites que direcionem .NET Framework 3,5 e em projetos de aplicativo Web que direcionem .NET Framework 3,0 ou .NET Framework 3,5.Se você quiser adicionar uma referência de serviço a um site da Web que direciona .NET Framework 3,0, você pode adicionar a referência de serviço a um projeto de biblioteca de classes.Você pode fazer referência do projeto de biblioteca de classes a partir projeto do site.
| Observação: |
|---|
Bibliotecas de classe não podem ser adicionadas a um projeto no Visual Web Developer. |
Usando o IntelliSense
Os serviços de idioma em Visual Studio 2008 não direcionam versões específicas do .NET Framework.Portanto, o editor sempre fornece o IntelliSense para as versões mais recentes de C# e Visual Basic.
Os projetos Web exibem IntelliSense para todos as versões .NET Framework, independente da versão do framework na qual o projeto está definido.Quando você seleciona .NET Framework versão 2,0 ou .NET Framework 3,0, qualquer código que faz referência a recursos do .NET Framework versão 3.5 resulta em erros de compilador.
JScript IntelliSense é independente da versão .NET Framework na qual o projeto está definido.
Implantando um projeto
As ferramentas Copy Web e publicar no Visual Studio 2008 não destino versões específicas da .NET Framework. Visual Studio não verifica a versão do .NET Framework que está executando em um servidor remoto. Essas ferramentas não conseguem notificá-lo se você publicar um projeto em um servidor de destino que contenha uma versão anterior do .NET Framework que a versão na qual seu projeto está definido.Nesse caso, um projeto que seleciona uma versão mais recente do .NET Framework não será executado.
Voltar ao topo
Consulte também
Conceitos
Novidades do ASP.NET e desenvolvimento da Web
Referência
Voltar ao topo