All 15 .NET CLI, SDK & Project Structure (csproj) questions
More in .NET CLI, SDK & Project Structure (csproj)
How do global.json files pin a specific .NET SDK version for a project or repository? What is the difference between framework-dependent deployment (FDD) and self-contained deployment (SCD)? How do you add, remove, and list NuGet package references using the dotnet CLI? What is the difference between dotnet build, dotnet publish, and dotnet run? What is Directory.Build.props, and how does it help manage shared MSBuild settings across multiple projects in a repository? What is Native AOT (Ahead-of-Time) compilation, and what are its benefits and constraints? How do project references (<ProjectReference>) differ from package references, and how do they affect build order?
Advertisement
Back to results for “Project Structure”
.NET › .NET CLI, SDK & Project Structure (csproj)

What are MSBuild properties and items, and how do they control the build process?

Advanced

Answer

MSBuild properties (in PropertyGroup, e.g., <TargetFramework>, <Nullable>, <LangVersion>) are single named values controlling build behavior, while items (in ItemGroup, e.g., <PackageReference>, <Compile>, <ProjectReference>) represent lists of inputs like source files, package dependencies, or project references. MSBuild evaluates these to construct and execute the actual build graph (compilation, resource embedding, packaging).
<PropertyGroup>
  <OutputType>Exe</OutputType>
  <LangVersion>latest</LangVersion>
</PropertyGroup>
<ItemGroup>
  <Compile Remove="Legacy/**/*.cs" />
  <ProjectReference Include="..\MyLib\MyLib.csproj" />
</ItemGroup>
Real-world example A project excludes an obsolete Legacy folder from compilation using a Compile Remove item, keeping the dead code in source control for reference without it being built.

Common follow-ups: How do custom MSBuild targets extend the build process?;What's the difference between PropertyGroup and ItemGroup evaluation order?

Assemblies & NuGet;Diagnostics & Performance
All 15 .NET CLI, SDK & Project Structure (csproj) questions