BuildManager.TargetFramework Properti

Definisi

Ruang nama:

System.Web.Compilation

Rakitan:

System.Web.dll

Mendapatkan versi target .NET Framework untuk situs Web saat ini.

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

Nilai Properti

FrameworkName

Versi target .NET Framework untuk situs Web saat ini.

Keterangan

Properti ini mendukung fitur multi-penargetan ASP.NET, yang memungkinkan Anda menggunakan versi terbaru Visual Studio untuk mengembangkan aplikasi yang akan berjalan dengan versi .NET Framework yang lebih lama. Penyedia build dapat menggunakan properti ini untuk memastikan bahwa penyedia menghasilkan kode yang sesuai untuk versi .NET Framework yang ditargetkan. Misalnya, Anda mungkin ingin menghasilkan kode yang berbeda tergantung pada apakah situs Web menargetkan .NET Framework 3.5 atau .NET Framework 4. Untuk informasi selengkapnya tentang multi-penargetan, lihat .NET Framework Multi-Targeting for ASP.NET Web Projects.

Jika situs Web tidak memiliki file Web.config, ASP.NET mengasumsikan bahwa versi kerangka kerja target adalah versi yang terkait dengan kumpulan aplikasi IIS yang dijalankan situs. Untuk situs Web sistem file yang berjalan di Visual Studio, versi kerangka kerja default adalah versi .NET Framework saat ini.

Jika situs Web memang memiliki file Web.config, ASP.NET menentukan kerangka kerja target dengan memeriksa file Web.config.

Situs Web yang Menargetkan .NET Framework 2.0

Aplikasi web yang menargetkan .NET Framework 2.0 dikompilasi seolah-olah targetnya adalah .NET Framework 3.0. Proses build tidak membedakan antara .NET Framework 2.0 dan .NET Framework 3.0 karena file Web.config tidak menunjukkan versi pengkompilasi atau kerangka kerja target ketika salah satu versi tersebut ditargetkan. (Untuk .NET Framework 3.5, file Web.config menentukan versi pengkompilasi, dan untuk .NET Framework 4, file Web.config menentukan kerangka kerja target.) Oleh karena itu, untuk aplikasi Web yang menargetkan .NET Framework 2.0, properti ini mengembalikan moniker kerangka kerja target yang menunjukkan .NET Framework 3.0.

Ini biasanya tidak akan menyebabkan masalah. Visual Studio mencegah Anda membuat referensi ke fitur .NET Framework 3.0 dalam proyek yang ditargetkan untuk .NET Framework 2.0. Misalnya, Visual Studio tidak menyediakan templat item untuk layanan WCF dalam proyek yang ditargetkan untuk .NET Framework 2.0, karena WCF diperkenalkan dengan .NET Framework 3.0 dan tidak kompatibel dengan .NET Framework 2.0.

Jika Anda berencana untuk menyebarkan situs Web di lingkungan run-time .NET Framework 2.0 dan Anda menggunakan alat selain Visual Studio untuk mereferensikan fitur yang hanya kompatibel dengan .NET Framework 3.0, proyek mungkin dibuat tanpa menghasilkan kesalahan atau peringatan. Namun, aplikasi mungkin menghasilkan kesalahan ketika situs Web berjalan pada .NET Framework 2.0.