Pliki MSBuild .targets
Program MSBuild zawiera kilka .targets plików, które zawierają elementy, właściwości, obiekty docelowe i zadania dla typowych scenariuszy. Te pliki są automatycznie importowane do większości plików projektu programu Visual Studio, aby uprościć konserwację i czytelność.
Projekty w stylu zestawu SDK (projekty z czymś takim jak <Project Sdk="Microsoft.NET.Sdk">) importują .targets pliki inaczej niż projekty, które nie odwołują się do zestawu SDK. W przypadku projektów w stylu zestawu SDK nie widać zaimportowanych .targets plików w pliku projektu, ponieważ te importy są zarządzane przez zestaw SDK, do którego się odwołujesz. Jednak projekty w stylu zestawu SDK są równoważne projektom w stylu innych niż zestaw SDK ze standardowymi importami przed i po głównej treści pliku, dlatego nadal dokładne jest stwierdzenie, że standardowe .targets pliki są importowane w tych projektach.
Elementy docelowe zestawu .NET SDK są instalowane z zestawem .NET SDK, na przykład w C:\Program Files\dotnet\sdk\{version}\Sdks\Microsoft.NET.Sdk\targets\ lokalizacji dla Microsoft.NET.Sdk systemu Windows. Aby uzyskać pełną listę zestawów SDK i importowanych .targets plików, zobacz Zestawy SDK projektu platformy .NET.
Projekty, które nie określają zestawu SDK, zwykle jawnie importują jeden lub więcej .targets plików w celu zdefiniowania procesu kompilacji. Na przykład projekty języka C# utworzone we wcześniejszych wersjach programu Visual Studio importuje obiekty Microsoft.CSharp.targets, które importuje obiekty Microsoft.Common.targets. Sam projekt języka C# definiuje elementy i właściwości specyficzne dla tego projektu, ale standardowe reguły kompilacji dla projektu języka C# są zdefiniowane w zaimportowanych .targets plikach.
Wartość $(MSBuildToolsPath) określa ścieżkę tych typowych .targets plików. W przypadku projektów platformy .NET ścieżka jest zwykle następująca {Visual Studio installation folder}\MSBuild\Current\Bin\{architecture}: .
Uwaga
Aby uzyskać informacje na temat tworzenia własnych obiektów docelowych, zobacz Cele. Aby uzyskać informacje na temat sposobu użycia Import elementu w celu wstawienia pliku projektu do innego pliku projektu, zobacz Import element (MSBuild) i How to: Use the same target in multiple project files (Importowanie elementu (MSBuild) i How to: Use the same target in multiple project files (Jak używać tego samego obiektu docelowego w wielu plikach projektu).
Typowe .targets pliki
| Plik targets | opis |
|---|---|
| Microsoft.common.targets | Definiuje kroki w standardowym procesie kompilacji dla projektów Visual Basic i C#. Zaimportowane przez pliki Microsoft.CSharp.targets i Microsoft.VisualBasic.targets , które zawierają następującą instrukcję: <Import Project="Microsoft.Common.targets" /> |
| Microsoft.CSharp.targets | Definiuje kroki w standardowym procesie kompilacji dla projektów Visual C#. Zaimportowane przez pliki projektu Visual C# ( .csproj). |
| Microsoft.VisualBasic.targets | Definiuje kroki w standardowym procesie kompilacji dla projektów Visual Basic. Zaimportowane przez pliki projektu Visual Basic ( .vbproj). |
Jeśli otwierasz i wyświetlasz pliki, zobaczysz, że są one raczej cienkimi otokami wokół innych .targets plików, zwykle Microsoft.{language}.CurrentVersion.targets, lub w scenariuszach obejmujących wiele elementów docelowych, Microsoft.{language}.CrossTargeting.targets.
Directory.Build.targets
Directory.Build.targets to plik zdefiniowany przez użytkownika, który zapewnia dostosowania projektów w katalogu. Ten plik jest automatycznie importowany z obiektów Microsoft.Common.targets , chyba że właściwość ImportDirectoryBuildTargets ma wartość false. Aby uzyskać więcej informacji, dostosuj kompilację.