Partilhar via


BuildManager.TargetFramework Propriedade

Definição

Obtém a versão de destino do .NET Framework para o site atual.

public:
 static property System::Runtime::Versioning::FrameworkName ^ TargetFramework { System::Runtime::Versioning::FrameworkName ^ get(); };
public static System.Runtime.Versioning.FrameworkName TargetFramework { get; }
static member TargetFramework : System.Runtime.Versioning.FrameworkName
Public Shared ReadOnly Property TargetFramework As FrameworkName

Valor da propriedade

A versão de destino do .NET Framework para o site atual.

Comentários

Essa propriedade dá suporte ao recurso ASP.NET multiplataforma, que permite que você use a versão mais recente do Visual Studio para desenvolver aplicativos que serão executados com versões anteriores do .NET Framework. Um provedor de build pode usar essa propriedade para garantir que o provedor gere código apropriado para a versão de destino do .NET Framework. Por exemplo, talvez você queira gerar um código diferente dependendo se um site tem como destino o .NET Framework 3.5 ou o .NET Framework 4. Para obter mais informações sobre multiplataforma, consulte Multiplataforma do .NET Framework para projetos Web ASP.NET.

Se o site não tiver um arquivo Web.config, ASP.NET pressupõe que a versão da estrutura de destino seja a versão associada ao pool de aplicativos do IIS no qual o site está sendo executado. Para um site do sistema de arquivos em execução no Visual Studio, a versão da estrutura padrão é a versão atual do .NET Framework.

Se o site tiver um arquivo Web.config, ASP.NET determinará a estrutura de destino examinando o arquivo de Web.config.

Sites direcionados ao .NET Framework 2.0

Os aplicativos Web direcionados ao .NET Framework 2.0 são compilados como se o destino fosse o .NET Framework 3.0. O processo de build não diferencia entre o .NET Framework 2.0 e o .NET Framework 3.0 porque o arquivo Web.config não indica a versão do compilador ou a estrutura de destino quando uma dessas versões é direcionada. (Para o .NET Framework 3.5, o arquivo Web.config especifica a versão do compilador e, para o .NET Framework 4, o arquivo Web.config especifica a estrutura de destino.) Portanto, para aplicativos Web direcionados ao .NET Framework 2.0, essa propriedade retorna um moniker de estrutura de destino que indica o .NET Framework 3.0.

Isso normalmente não causará problemas. O Visual Studio impede que você crie referências a recursos do .NET Framework 3.0 em um projeto direcionado para o .NET Framework 2.0. Por exemplo, o Visual Studio não fornece modelos de item para serviços WCF em um projeto destinado ao .NET Framework 2.0, pois o WCF foi introduzido com o .NET Framework 3.0 e não é compatível com o .NET Framework 2.0.

Se você planeja implantar um site em um ambiente de tempo de execução do .NET Framework 2.0 e usar uma ferramenta diferente do Visual Studio para referenciar recursos compatíveis apenas com o .NET Framework 3.0, o projeto poderá ser compilado sem gerar erros ou avisos. No entanto, o aplicativo pode gerar erros quando o site é executado no .NET Framework 2.0.

Aplica-se a