BuildManager.TargetFramework Proprietà

Definizione

Spazio dei nomi:

System.Web.Compilation

Assembly:

System.Web.dll

Ottiene la versione di destinazione di .NET Framework per il sito Web corrente.

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

Valore della proprietà

FrameworkName

Versione di destinazione di .NET Framework per il sito Web corrente.

Commenti

Questa proprietà supporta la funzionalità ASP.NET multi-targeting, che consente di usare la versione più recente di Visual Studio per sviluppare applicazioni che verranno eseguite con le versioni precedenti di .NET Framework. Un provider di compilazione può usare questa proprietà per assicurarsi che il provider generi codice appropriato per la versione di destinazione di .NET Framework. Ad esempio, è possibile generare codice diverso a seconda che un sito Web sia destinato a .NET Framework 3.5 o .NET Framework 4. Per altre informazioni sul multi-targeting, vedere .NET Framework Multi-Targeting per ASP.NET progetti Web.

Se il sito Web non ha un file Web.config, ASP.NET presuppone che la versione del framework di destinazione sia la versione associata al pool di applicazioni IIS in esecuzione nel sito. Per un sito Web file system in esecuzione in Visual Studio, la versione predefinita del framework è la versione corrente di .NET Framework.

Se il sito Web ha un file Web.config, ASP.NET determina il framework di destinazione esaminando il file di Web.config.

Siti Web destinati a .NET Framework 2.0

Le applicazioni Web destinate a .NET Framework 2.0 vengono compilate come se la destinazione fosse .NET Framework 3.0. Il processo di compilazione non distingue tra .NET Framework 2.0 e .NET Framework 3.0 perché il file di Web.config non indica la versione del compilatore o il framework di destinazione quando una di queste versioni è destinata. Per .NET Framework 3.5, il file Web.config specifica la versione del compilatore e per .NET Framework 4, il file Web.config specifica il framework di destinazione. Pertanto, per le applicazioni Web destinate a .NET Framework 2.0, questa proprietà restituisce un moniker del framework di destinazione che indica .NET Framework 3.0.

Questo normalmente non causerà problemi. Visual Studio impedisce di creare riferimenti alle funzionalità di .NET Framework 3.0 in un progetto destinato a .NET Framework 2.0. Ad esempio, Visual Studio non fornisce modelli di elemento per i servizi WCF in un progetto destinato a .NET Framework 2.0, perché WCF è stato introdotto con .NET Framework 3.0 e non è compatibile con .NET Framework 2.0.

Se si prevede di distribuire un sito Web in un ambiente di esecuzione di .NET Framework 2.0 e si usa uno strumento diverso da Visual Studio per fare riferimento alle funzionalità compatibili solo con .NET Framework 3.0, il progetto potrebbe compilare senza generare errori o avvisi. Tuttavia, l'applicazione potrebbe generare errori quando il sito Web viene eseguito in .NET Framework 2.0.