Skip to main content

.NET supported technologies

The .NET agent supports these technologies:

Technology

Supported versions

Notes

Application frameworks

  • ASP.NET Core (3.1.X, 5.0.X 6.0.X, 7.0.X, 8.0X)

  • ASP.NET MVC 3-5

  • ASP.NET Web Forms

  • ASP.NET Web Pages

  • IIS-Hosted ASMX-based Web Services

  • IIS-Hosted Web API

  • IIS-Hosted WCF Services

  • OWIN Hosted API (via a Windows service or a command line application)

  • Model-View-Controller (MVC)

  • Razor Pages

  • Grpc.AspNetCore

These frameworks are explicitly tested, however, you may still be able to analyze other applications if the framework simply wraps the typical ASP.NET classes (for example, System.Web.HttpRequest).

Limited support

ASP .NET Core 3.1.X and 5.0.X

Not supported:

  • .NET Core or ASP.NET Core version 2.1 or earlier

  • ASP.NET Core applications running under the .NET Framework (Windows) or Mono (Linux/Windows)

  • Analysis of .NET Framework ASP.NET Core applications (use our .NET Core agent to analyze .NET Core applications)

  • Grpc.Core

    The future of gRPC in C# belongs to grpc-dotnet contains additional details.

  • Applications running under partial trust.

Application runtimes

  • .NET Core runtimes: 3.1.X, 5.0.X, 6.0.X , 7.0.X. 8.0X

  • .NET Core target framework monikers:

    • netcoreapp3.1

    • net5.0

    • net6.0

    • net7.0

    • net8.0

  • .NET Framework runtimes: 4.5 and later

Most users are able to use the modern .NET Framework agent, even if their application targets an older version of .NET 4, due to .NET framework application compatibility.

Limited support:

.NET Core Runtimes 3.1.x and 5.0.X

Not supported:

  • Running with an ASP.NET Core application that's a higher version than the runtime (for example, an application with the .NET Core 3.1 runtime that references ASP.NET Core 5.0)

  • Running with a .NET Core application for which the referenced ASP.NET Core version and the target runtime selected during compilation time don't match

  • Classic ASP

    Classic ASP applications don't run on the .NET runtime

  • Mono runtime

    The agent uses the CLR Profiling API to instrument applications. The CLR Profiling API is a Component Object Model (COM)-based interface exposed by the CLR. Linux does not support COM. Therefore Mono does not support the CLR Profiling API and Contrast cannot support Mono.

Server runtimes

4.7.1, 4.7.2, 4.8

<NOTE TO REVIWERS:.NET FRAMEWORK ONLY OR BOTH?>

Common Language Runtime (CLR)

CLR 4

<.NOTE TO REVIEWERS: NET FRAMEWORK ONLY OR BOTH?>

Web servers

  • IIS

  • IIS Express

.NET Core for Windows

Windows operating systems

  • Windows Server (LTSC) (x86, x64): 2012 R2, 2016, 2019, 2022

  • Windows Server (SAC) (x64): 1809, 1903

  • Windows workstation (x86, x64): 7, 8/8.1, 10

On 64-bit systems, you can use the agent to analyze both 32-bit and 64-bit web applications.

Not supported:

  • Windows on ARM

Server container

Kestrel, IISHttpServer

Not supported:

Http.sys (formerly called WebListener)

Hosting container

Self-hosted, IIS, IIS Express

.NET Core for Linux operating systems

Linux operating systems

  • Ubuntu: 18.04 and later (x64, ARM64)

  • Debian: 10 and later (x64, ARM64)

  • openSUSE: 15 and later (x64)

  • Alpine: 3.13 and later (x64, ARM64)

  • CentOS: 7 (x64)

  • CentOS Stream 8 (x64)

  • Red Hat Enterprise Linux: 7 and later (x64)

Not supported: Red Hat Enterprise Linux 6

Server container

Kestrel

Hosting container

Self-hosted

.NET Core technology notes

  • .NET Core 2.2 is not supported after the .NET core agent version 1.5.20. If you are using .NET Core 2.2, you'll need to use .NET Core agent version 1.5.20 or lower until you can upgrade your application’s .NET Core runtime.

  • As of .NET core agent version 1.9.9, Contrast no longer supports .NET Core 2.1. If you are using .NET Core 2.1, you'll need to use .NET Core agent version 1.9.9 or lower until you can upgrade your application’s .NET Core runtime.

  • Microsoft support for .NET 5.0 ended on May 10th, 2022 and support for .NET Core 3.1 ended on December 13th, 2022. Contrast support for .NET 5.0 and .NET Core 3.1 entered limited support with .NET Core agent version 3.0.0. Under limited support, Contrast will only solve problems that can be reproduced under supported language versions. Contrast strongly recommends that you upgrade your applications to a supported version of .NET.

  • .NET Core applications must use the .NET Core-specific site extension or NuGet package.

  • The .NET Core agent does not support applications that do not reference System.Runtime and ASPNET Core. The agent also does not support trimmed self-contained deployments and executables, because the compiler can potentially trim assemblies that the agent depends on.

.NET Framework technology notes

For Azure App Service, .NET Framework applications must use the .NET Framework site extension or NuGet package.