.NET Modernization Skill

Legacy .csproj (SDK-style conversion)

<!-- Legacy format -->
<Project ToolsVersion="15.0">
  <PropertyGroup>
    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
  </PropertyGroup>
  <ItemGroup>
    <Reference Include="System.Web" />
  </ItemGroup>
</Project>

<!-- Modern SDK-style -->
<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
</Project>

Configuration Transformation

web.config → appsettings.json

See appsettings.json template for a complete example.

Authentication Migration

Windows Authentication → Entra ID

// Legacy Windows Auth
[Authorize]
public class SecureController : Controller
{
    var user = User.Identity.Name; // DOMAIN\username
}

// Modern Entra ID
builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddMicrosoftIdentityWebApi(builder.Configuration.GetSection("AzureAd"));

[Authorize]
public class SecureController : ControllerBase
{
    var user = User.FindFirst(ClaimTypes.Name)?.Value;
}

Forms Authentication → ASP.NET Core Identity

// Legacy Forms Auth in web.config
// <authentication mode="Forms">
//   <forms loginUrl="~/Account/Login" />
// </authentication>

// Modern ASP.NET Core Identity
builder.Services.AddIdentity<ApplicationUser, IdentityRole>()
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders();

builder.Services.ConfigureApplicationCookie(options =>
{
    options.LoginPath = "/Account/Login";
});

Entity Framework Migration

EF6 → EF Core

// EF6
public class LegacyContext : DbContext
{
    public LegacyContext() : base("DefaultConnection") { }
    public DbSet<Product> Products { get; set; }
}

// EF Core
public class ModernContext : DbContext
{
    public ModernContext(DbContextOptions<ModernContext> options) 
        : base(options) { }
    public DbSet<Product> Products { get; set; }
}

// Registration in Program.cs
builder.Services.AddDbContext<ModernContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

Package Mapping

Common Breaking Changes

1. HttpContext.Current - Not available; inject IHttpContextAccessor
2. ConfigurationManager - Use IConfiguration injection
3. Server.MapPath - Use IWebHostEnvironment.ContentRootPath
4. Session - Configure session middleware explicitly
5. Global.asax - Move to Program.cs and middleware
6. Bundling - Use npm/webpack or LibMan

Template Files

• Program.cs - Modern .NET 8 entry point
• appsettings.json - Configuration template
• Dockerfile - Container template for .NET 8

Best Practices

1. Use SDK-style projects - Simpler, cleaner project files
2. Enable nullable reference types - Better null safety
3. Use IConfiguration - Never use ConfigurationManager
4. Inject dependencies - Use built-in DI container
5. Use async/await - For all I/O operations
6. Configure middleware order - Order matters in the pipeline
7. Use ILogger - Consistent logging abstraction