Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion docs/core/tools/dotnet-build.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ title: dotnet build command
description: The dotnet build command builds a project and all of its dependencies.
ms.date: 09/24/2025
Comment thread
gewarren marked this conversation as resolved.
Outdated
---

# dotnet build

**This article applies to:** ✔️ .NET 6 SDK and later versions
Expand All @@ -22,6 +23,7 @@ dotnet build [<PROJECT>|<SOLUTION>|<FILE>] [-a|--arch <ARCHITECTURE>]
[--no-self-contained] [-o|--output <OUTPUT_DIRECTORY>] [--os <OS>]
[-p|--property:<PROPERTYNAME>=<VALUE>] [-r|--runtime <RUNTIME_IDENTIFIER>]
[--sc|--self-contained] [--source <SOURCE>]
[-t|--target <TARGET>]
[--tl:[auto|on|off]] [ --ucr|--use-current-runtime]
Comment thread
gewarren marked this conversation as resolved.
[-v|--verbosity <LEVEL>] [--version-suffix <VERSION_SUFFIX>]

Expand Down Expand Up @@ -155,6 +157,16 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev

The URI of the NuGet package source to use during the restore operation.

- **`-t|--target <TARGET>`**
Comment thread
classyk12 marked this conversation as resolved.
Outdated

Specifies one or more MSBuild targets to run during the build, instead of the default target. Multiple targets can be specified by separating them with a semicolon or by repeating the option. Corresponds to the MSBuild `-target` option. Common targets include `Build` (default), `Clean`, and `Rebuild`.. For more information about targets, see [MSBuild Targets](/visualstudio/msbuild/msbuild-targets).
Comment thread
classyk12 marked this conversation as resolved.
Outdated
Comment thread
classyk12 marked this conversation as resolved.
Outdated

Comment thread
classyk12 marked this conversation as resolved.
```dotnetcli
dotnet build -t:Clean
dotnet build -t:Rebuild
dotnet build -t:Clean;Build
Comment thread
classyk12 marked this conversation as resolved.
Outdated
```
Comment thread
classyk12 marked this conversation as resolved.
Outdated
Comment thread
classyk12 marked this conversation as resolved.
Outdated

- [!INCLUDE [tl](includes/cli-tl.md)]

- [!INCLUDE [use-current-runtime](includes/cli-use-current-runtime.md)]
Expand Down Expand Up @@ -203,6 +215,12 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev

- Build the project and set version 1.2.3.4 as a build parameter using the `-p` [MSBuild option](#msbuild):

```dotnetcli
```dotnetcli
Comment thread
classyk12 marked this conversation as resolved.
Outdated
dotnet build -p:Version=1.2.3.4
```

- Run the `Clean` target to remove previous build outputs:

```dotnetcli
dotnet build -t:Clean
Comment thread
classyk12 marked this conversation as resolved.
Outdated
```
Comment thread
classyk12 marked this conversation as resolved.
Outdated
Loading