Mémos & pièges

dotnet new list                    # modèles disponibles
dotnet new webapi -o Api           # API minimale
dotnet new blazor -o Web           # Blazor Web App
dotnet new classlib -o Domaine
dotnet new xunit -o Tests
dotnet new gitignore
dotnet new sln -n Boutique

dotnet sln add **/*.csproj
dotnet add reference ../Domaine/Domaine.csproj
dotnet package add Serilog.AspNetCore
dotnet package list --outdated
dotnet package list --vulnerable --include-transitive

dotnet build -warnaserror
dotnet run
dotnet run --launch-profile https
dotnet watch                       # rechargement à chaud
dotnet run -e Cle=valeur           # .NET 11
dotnet test
dotnet test --filter "FullyQualifiedName~Tarif"
dotnet format                      # met en forme
dotnet publish -c Release -o ./out
dotnet publish -c Release /t:PublishContainer
dotnet --info                      # diagnostic d'environnement

dotnet tool install --global dotnet-ef
dotnet ef migrations add NomExplicite
dotnet ef migrations list
dotnet ef migrations remove
dotnet ef database update
dotnet ef database update NomMigration   # revenir à un état
dotnet ef migrations script --idempotent -o m.sql
dotnet ef migrations bundle
dotnet ef dbcontext scaffold "conn" Microsoft.EntityFrameworkCore.SqlServer
dotnet ef dbcontext info

dotnet tool install --global dotnet-counters
dotnet tool install --global dotnet-trace
dotnet tool install --global dotnet-gcdump

dotnet-counters ps
dotnet-counters monitor -p 1234 \
  --counters System.Runtime,Microsoft.AspNetCore.Hosting
dotnet-trace collect -p 1234 --profile cpu-sampling
dotnet-gcdump collect -p 1234 -o snap.gcdump
dotnet user-secrets set "Cle" "valeur"

string? peutEtreNull;
x?.Membre                 // null si x est null
x?.Methode()              // idem
x ?? "defaut"             // valeur de repli
x ??= Calculer()          // affecter si null
x!.Membre                 // « je garantis » (danger)
x is null / is not null
ArgumentNullException.ThrowIfNull(x);
if (!int.TryParse(s, out var n)) n = 0;

o is Client c                  // type + variable
o is { Age: >= 18 }            // propriété
o is Client { Ville: "Lyon" } c
o is > 10 and < 20             // relationnel
o is "a" or "b"                // logique
liste is [var seul]            // liste
liste is [_, _, ..]            // au moins deux
var r = x switch { ... , _ => d };
var (a, b) = point;            // déconstruction

$"{prix:C}"        // 12,50 €
$"{taux:P1}"       // 12,3 %
$"{n:N2}"          // 1 234,56
$"{n:0.##}"        // 12,5
$"{d:dd/MM/yyyy}"  // 30/07/2026
$"{d:O}"           // ISO 8601
$"{nom,-20}"       // aligné à gauche
$"{n,10:N2}"       // aligné à droite
$"{{accolade}}"    // échapper
"""ligne 1
ligne 2"""         // chaîne brute

DateOnly       // une date sans heure (naissance)
TimeOnly       // une heure sans date (ouverture)
DateTime       // date + heure — préciser le Kind
DateTimeOffset // date + heure + décalage ⭐
TimeSpan       // une durée

// Règle : stocker en UTC, afficher en local
DateTimeOffset.UtcNow          // ⭐ le défaut
DateTime.UtcNow                // acceptable
DateTime.Now                   // ⚠️ dépend du serveur
TimeProvider                   // injectable, testable