0Pricing
C# Academy · Lesson

Configuring Asp.Versioning

Set up versioning in ASP.NET Core.

The Asp.Versioning Package

ASP.NET Core API versioning lives in the community-maintained Asp.Versioning packages (the successor to Microsoft.AspNetCore.Mvc.Versioning).

dotnet add package Asp.Versioning.Mvc
dotnet add package Asp.Versioning.Mvc.ApiExplorer

AddApiVersioning

Register versioning with AddApiVersioning. The options control the default version and how missing versions are handled.

builder.Services.AddApiVersioning(options =>
{
    options.DefaultApiVersion = new ApiVersion(1, 0);
    options.AssumeDefaultVersionWhenUnspecified = true;
    options.ReportApiVersions = true;
});

All lessons in this course

  1. API Versioning Strategies
  2. Configuring Asp.Versioning
  3. Generating OpenAPI Documents
  4. Documenting Versioned APIs
← Back to C# Academy