Platforma docelowa programu MSBuild

Projekt można utworzyć w celu uruchomienia na platformie docelowej, która jest określoną wersją programu .NET Framework i platformą docelową, która jest konkretną architekturą oprogramowania. Na przykład aplikację docelową można uruchomić na platformie .NET Framework 2.0 na 32-bitowej platformie zgodnej z rodziną procesorów 80x86 ("x86"). Kombinacja platformy docelowej i platformy docelowej jest znana jako kontekst docelowy.

Ważne

W tym artykule przedstawiono stary sposób określania platformy docelowej. Projekty w stylu zestawu SDK umożliwiają korzystanie z różnych elementów TargetFrameworks, takich jak netstandard. Aby uzyskać więcej informacji, zobacz Platformy docelowe.

Struktura docelowa i profil

Platforma docelowa to konkretna wersja programu .NET Framework, na podstawie którego projekt jest kompilowany. Wymagana jest specyfikacja platformy docelowej, ponieważ umożliwia ona funkcje kompilatora i odwołania do zestawów, które są przeznaczone wyłącznie dla tej wersji platformy.

Obecnie do użycia są dostępne następujące wersje programu .NET Framework:

  • Program .NET Framework 2.0 (dołączony do programu Visual Studio 2005)

  • Program .NET Framework 3.0 (dołączony do systemu Windows Vista)

  • Program .NET Framework 3.5 (dołączony do programu Visual Studio 2008)

  • .NET Framework 4.0

  • .NET Framework 4.5.2

  • Program .NET Framework 4.6 (dołączony do programu Visual Studio 2015)

  • .NET Framework 4.6.1

  • .NET Framework 4.6.2

  • .NET Framework 4.7

  • .NET Framework 4.7.1

  • .NET Framework 4.7.2

  • .NET Framework 4.8

Wersje programu .NET Framework różnią się od siebie na liście zestawów udostępnianych do odwołania. Na przykład nie można tworzyć aplikacji programu Windows Presentation Foundation (WPF), chyba że projekt jest przeznaczony dla programu .NET Framework w wersji 3.0 lub nowszej.

Struktura docelowa jest określona TargetFrameworkVersion we właściwości w pliku projektu. Możesz zmienić strukturę docelową projektu przy użyciu stron właściwości projektu w zintegrowanym środowisku projektowym (IDE) programu Visual Studio. Aby uzyskać więcej informacji, zobacz How to: Target a version of the .NET Framework (Instrukcje: określanie wersji docelowej programu .NET Framework). Dostępne wartości to TargetFrameworkVersion , , v3.0, v4.6v3.5v4.0v4.7v4.7.2v4.5.2v4.6.1v4.6.2v4.7.1i .v4.8v2.0

<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>

Profil docelowy jest podzbiorem platformy docelowej. Na przykład profil klienta programu .NET Framework 4 nie zawiera odwołań do zestawów MSBuild.

Uwaga

Profile docelowe mają zastosowanie tylko do przenośnych bibliotek klas.

Profil docelowy TargetFrameworkProfile jest określony we właściwości w pliku projektu. Profil docelowy można zmienić przy użyciu kontrolki platformy docelowej na stronach właściwości projektu w środowisku IDE.

<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
<TargetFrameworkProfile>Client</TargetFrameworkProfile>

Platforma docelowa

Platforma to kombinacja sprzętu i oprogramowania, które definiuje określone środowisko uruchomieniowe. Przykład:

  • x86 wyznacza 32-bitowy system operacyjny Windows, który jest uruchomiony na procesorze Intel 80x86 lub jego odpowiedniku.
  • x64 wyznacza 64-bitowy system operacyjny Windows uruchomiony na procesorze Intel x64 lub jego odpowiedniku.
  • anycpu wyznacza dane wyjściowe skonfigurowane do uruchamiania na dowolnej platformie. Aplikacja działa jako proces 64-bitowy, gdy jest to możliwe i wraca do 32-bitowego, gdy tylko ten tryb jest dostępny.
  • anycpu32bitpreferred wyznacza dane wyjściowe uruchamiane na dowolnej platformie. Aplikacja działa w trybie 32-bitowym w systemach obsługujących zarówno aplikacje 64-bitowe, jak i 32-bitowe.
  • Xbox wyznacza platformę Microsoft Xbox 360.
  • ARM Kompiluje zestaw do uruchomienia na komputerze z procesorem Advanced RISC Machine (ARM).
  • ARM64 Kompiluje zestaw do uruchamiania na 64-bitowym środowisku CLR na komputerze z procesorem Advanced RISC Machine (ARM), który obsługuje zestaw instrukcji A64.

Platforma docelowa to konkretna platforma , na którą jest tworzony projekt. Platforma docelowa jest określona we właściwości kompilacji PlatformTarget w pliku projektu. Platformę docelową można zmienić przy użyciu stron właściwości projektu lub programu Configuration Manager w środowisku IDE.

<PropertyGroup>
   <PlatformTarget>x86</PlatformTarget>
</PropertyGroup>

Wartość PlatformTarget jest przekazywana do kompilatora, aby określić, jakie dane wyjściowe mają być generowane. W przypadku projektów języka C# mapuje na opcję -platformkompilatora języka C#. Opcje platformy opisano bardziej szczegółowo w temacie Opcje kompilatora: PlatformTarget.

Konfiguracja docelowa jest podzbiorem platformy docelowej. Na przykład x86Debug konfiguracja nie obejmuje większości optymalizacji kodu. Konfiguracja docelowa jest określona Configuration we właściwości kompilacji w pliku projektu. Konfigurację docelową można zmienić przy użyciu stron właściwości projektu lub programu Configuration Manager.

<PropertyGroup>
   <PlatformTarget>x86</PlatformTarget>
   <Configuration>Debug</Configuration>
</PropertyGroup>