All 15 .NET CLI, SDK & Project Structure (csproj) questions
More in .NET CLI, SDK & Project Structure (csproj)
What does `dotnet new` do, and how do you list available project templates? What does the `dotnet watch` command do, and how does it speed up local development? What is the structure and purpose of a .csproj file in a modern SDK-style .NET project? What is a .sln (solution) file, and how does it relate to .csproj project files? 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 are MSBuild properties and items, and how do they control the build process? What is Directory.Build.props, and how does it help manage shared MSBuild settings across multiple projects in a repository?
Advertisement
.NET › .NET CLI, SDK & Project Structure (csproj)

How does target framework moniker (TFM) selection, like net8.0 or net8.0-windows, affect what a project can do?

Intermediate

Answer

The TargetFramework property specifies which .NET version's APIs and behaviors the project compiles against; platform-specific TFMs like net8.0-windows unlock Windows-only APIs (e.g., WinForms, Registry access) at the cost of losing cross-platform compatibility. Choosing the right TFM balances access to newer APIs and platform features against the breadth of environments the application can run on.
<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
  <!-- vs -->
  <TargetFramework>net8.0-windows</TargetFramework>
</PropertyGroup>
Real-world example A cross-platform background service targets plain net8.0 to run on Linux containers, while a companion WinForms configuration tool targets net8.0-windows to access Windows-specific UI APIs.

Common follow-ups: How does multi-targeting (net8.0;net481) work in one csproj?;What happens if you reference a platform-specific API without the right TFM?

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