Skip to main content
📜 WAYPOINT LESSON

The .csproj file

⭐ beginner⏳ 12 min read📍 Lesson 70 of 85

A project file is data: target framework, project references, and build settings in XML.

Anatomy

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
</Project>
  • Sdk — which build toolset owns the file (the modern, convention-based SDK).
  • OutputType — Exe (console app) or library (the line is absent).
  • TargetFramework — the runtime API surface your code compiles against: net10.0 means .NET 10 APIs.
  • Nullable — turns nullable-reference-type warnings on.
  • ImplicitUsings — injects the common using lines so every file doesn't repeat them.

Source files are discovered by convention: every .cs under the project directory compiles. You never list them.

What beginners touch

Almost nothing at first — dotnet new console writes a correct file. You'll edit it when you add a dependency (<PackageReference>), reference another project (<ProjectReference>), or flip Nullable.