BuildManager.TargetFramework Właściwość

Definicja

Przestrzeń nazw:

System.Web.Compilation

Zestaw:

System.Web.dll

Pobiera wersję docelową programu .NET Framework dla bieżącej witryny sieci Web.

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

Wartość właściwości

FrameworkName

Docelowa wersja programu .NET Framework dla bieżącej witryny sieci Web.

Uwagi

Ta właściwość obsługuje funkcję wielowersyjności ASP.NET, która umożliwia używanie najnowszej wersji programu Visual Studio do tworzenia aplikacji uruchamianych z wcześniejszymi wersjami programu .NET Framework. Dostawca kompilacji może użyć tej właściwości, aby upewnić się, że dostawca generuje kod odpowiedni dla docelowej wersji programu .NET Framework. Na przykład możesz wygenerować inny kod w zależności od tego, czy witryna sieci Web jest przeznaczona dla programu .NET Framework 3.5, czy .NET Framework 4. Aby uzyskać więcej informacji na temat wielowersyjnych elementów docelowych, zobacz .NET Framework Multi-Target for ASP.NET Web Projects .NET Framework Multi-Target for ASP.NET Web Projects (Multi-Target for ASP.NET Web Projects).

Jeśli witryna sieci Web nie ma pliku Web.config, ASP.NET zakłada, że wersja platformy docelowej jest wersją skojarzoną z pulą aplikacji usług IIS, w ramach których działa witryna. W przypadku witryny sieci Web systemu plików uruchomionej w programie Visual Studio domyślna wersja platformy to bieżąca wersja programu .NET Framework.

Jeśli witryna sieci Web ma plik Web.config, ASP.NET określa strukturę docelową, sprawdzając plik Web.config.

Witryny sieci Web przeznaczone dla programu .NET Framework 2.0

Aplikacje internetowe przeznaczone dla programu .NET Framework 2.0 są kompilowane tak, jakby element docelowy to .NET Framework 3.0. Proces kompilacji nie rozróżnia programu .NET Framework 2.0 i .NET Framework 3.0, ponieważ plik Web.config nie wskazuje wersji kompilatora ani struktury docelowej, gdy jedna z tych wersji jest przeznaczona. (W przypadku programu .NET Framework 3.5 plik Web.config określa wersję kompilatora, a dla programu .NET Framework 4 plik Web.config określa strukturę docelową). W związku z tym w przypadku aplikacji internetowych przeznaczonych dla programu .NET Framework 2.0 ta właściwość zwraca nazwę docelową platformy, która wskazuje program .NET Framework 3.0.

Zwykle nie spowoduje to żadnych problemów. Program Visual Studio uniemożliwia tworzenie odwołań do funkcji programu .NET Framework 3.0 w projekcie przeznaczonym dla programu .NET Framework 2.0. Na przykład program Visual Studio nie udostępnia szablonów elementów dla usług WCF w projekcie przeznaczonym dla programu .NET Framework 2.0, ponieważ WCF został wprowadzony z programem .NET Framework 3.0 i nie jest zgodny z programem .NET Framework 2.0.

Jeśli planujesz wdrożyć witrynę sieci Web w środowisku uruchomieniowym .NET Framework 2.0 i używasz narzędzia innego niż Program Visual Studio do odwołowania się do funkcji zgodnych tylko z programem .NET Framework 3.0, projekt może być kompilowane bez generowania błędów lub ostrzeżeń. Jednak aplikacja może generować błędy, gdy witryna sieci Web działa na platformie .NET Framework 2.0.