Share via


File MSBuild .targets

MSBuild include diversi .targets file che contengono elementi, proprietà, destinazioni e attività per scenari comuni. Questi file vengono importati automaticamente nella maggior parte dei file di progetto di Visual Studio per semplificare la manutenzione e la leggibilità.

I progetti in stile SDK (progetti con qualcosa di simile <Project Sdk="Microsoft.NET.Sdk">) importano .targets file in modo diverso rispetto ai progetti che non fanno riferimento a un SDK. Per i progetti in stile SDK, non viene visualizzato il file importato .targets nel file di progetto, perché tali importazioni vengono gestite dall'SDK a cui si fa riferimento. Tuttavia, i progetti in stile SDK sono equivalenti a progetti non in stile SDK con importazioni standard prima e dopo il corpo principale del file, quindi è ancora accurato dire che i file standard .targets vengono importati in tali progetti.

Le destinazioni .NET SDK vengono installate con .NET SDK, ad esempio in per C:\Program Files\dotnet\sdk\{version}\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk in Windows. Per un elenco completo degli SDK e del .targets file che importano, vedere SDK di progetto .NET.

I progetti che non specificano un SDK in genere importano in modo esplicito uno o più .targets file per definire il processo di compilazione. Ad esempio, i progetti C# creati dalle versioni precedenti di Visual Studio importano Microsoft.CSharp.targets, che importaNo Microsoft.Common.targets. Il progetto C# definisce gli elementi e le proprietà specifici del progetto, ma le regole di compilazione standard per un progetto C# vengono definite nei file importati .targets .

Il $(MSBuildToolsPath) valore specifica il percorso di questi file comuni .targets . Per i progetti .NET, il percorso è in {Visual Studio installation folder}\MSBuild\Current\Bin\{architecture}genere .

Nota

Per informazioni su come creare destinazioni personalizzate, vedere Destinazioni. Per informazioni su come usare l'elemento Import per inserire un file di progetto in un altro file di progetto, vedere Elemento Import (MSBuild) e Procedura: Usare la stessa destinazione in più file di progetto.

File comuni .targets

File con estensione targets Descrizione
Microsoft.Common.targets Definisce i passaggi del processo di compilazione standard per i progetti Visual Basic e C#.

Importato dai file Microsoft.CSharp.targets e Microsoft.VisualBasic.targets, che includono l'istruzione seguente: <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Definisce i passaggi nel processo di compilazione standard per i progetti di Visual C#.

Importato dai file di progetto Visual C# (.csproj).
Microsoft.VisualBasic.targets Definisce i passaggi nel processo di compilazione standard per i progetti di Visual Basic.

Importato dai file di progetto di Visual Basic (.vbproj).

Se si aprono e visualizzano i file, si noterà che sono piuttosto thin wrapper intorno ad altri .targets file, in genere Microsoft.{language}.CurrentVersion.targets, o per scenari di selezione incrociata, Microsoft.{language}.CrossTargeting.targets.

Directory.Build.targets

Directory.Build.targets è un file definito dall'utente che specifica le personalizzazioni dei progetti in una directory. Questo file viene importato automaticamente da Microsoft.Common.targets, a meno che la proprietà ImportDirectoryBuildTargets sia impostata su False. Per altre informazioni, vedere Personalizzare la compilazione.

Vedi anche