.NET Extensions

.NET Extensions is an open-source, cross-platform set of APIs for commonly used programming patterns and utilities, such as dependency injection, logging, and app configuration. Most of the API in this project is meant to work on many .NET platforms, such as .NET Core, .NET Framework, Xamarin, and others. While commonly used in ASP.NET Core applications, these APIs are not coupled to the ASP.NET Core application model. They can be used in console apps, WinForms and WPF, and others.

*** Important Updates ***

As part of the ongoing repository consolidation effort in .NET 5, we have moved most of the content from dotnet/extensions into other repositories. Most of these packages were developed by and are currently maintained by the ASP.NET team. However, moving forward we want to enable more scenarios with these packages, outside of ASP.NET. You can find more details on this in the official announcement of the changes coming to extensions.

The full list of packages that have moved can be found below and in the official announcement. In general, tests and samples have moved to the relevant repo based on where the main package moved. Issue tracking for the relevant packages has also moved to that repository.

Package List

The following list identifies all the packages we currently ship from dotnet/extensions and which repo they have moved to.

• Moved to dotnet/runtime
  • Caching
    • Microsoft.Extensions.Caching.Abstractions
    • Microsoft.Extensions.Caching.Memory
  • Configuration
    • Microsoft.Extensions.Configuration
    • Microsoft.Extensions.Configuration.Abstractions
    • Microsoft.Extensions.Configuration.Binder
    • Microsoft.Extensions.Configuration.CommandLine
    • Microsoft.Extensions.Configuration.EnvironmentVariables
    • Microsoft.Extensions.Configuration.FileExtensions
    • Microsoft.Extensions.Configuration.Ini
    • Microsoft.Extensions.Configuration.Json
    • Microsoft.Extensions.Configuration.UserSecrets
    • Microsoft.Extensions.Configuration.Xml
  • Dependency Injection
    • Microsoft.Extensions.DependencyInjection
    • Microsoft.Extensions.DependencyInjection.Abstractions
  • File Providers
    • Microsoft.Extensions.FileProviders.Abstractions
    • Microsoft.Extensions.FileProviders.Composite
    • Microsoft.Extensions.FileProviders.Physical
  • File System Globbing
    • Microsoft.Extensions.FileSystemGlobbing
  • Hosting
    • Microsoft.Extensions.Hosting
    • Microsoft.Extensions.Hosting.Abstractions
  • Http Client Factory
    • Microsoft.Extensions.Http
  • Logging
    • Microsoft.Extensions.Logging
    • Microsoft.Extensions.Logging.Abstractions
    • Microsoft.Extensions.Logging.Configuration
    • Microsoft.Extensions.Logging.Console
    • Microsoft.Extensions.Logging.Debug
    • Microsoft.Extensions.Logging.EventLog
    • Microsoft.Extensions.Logging.EventSource
    • Microsoft.Extensions.Logging.Testing
    • Microsoft.Extensions.Logging.TraceSource
  • Options
    • Microsoft.Extensions.Options
    • Microsoft.Extensions.Options.ConfigurationExtensions
    • Microsoft.Extensions.Options.DataAnnotations
  • Primitives
    • Microsoft.Extensions.Primitives
• Moved to dotnet/aspnetcore
  • Configuration
    • Microsoft.Extensions.Configuration.KeyPerFile
  • File Providers
    • Microsoft.Extensions.FileProviders.Embedded
    • Microsoft.Extensions.FileProviders.Embedded.Manifest.Task
  • Health Checks
    • Microsoft.Extensions.Diagnostics.HealthChecks
    • Microsoft.Extensions.Diagnostics.HealthChecks.Abstractions
  • JS Interop
    • Microsoft.JSInterop
    • Mono.WebAssembly.Interop
  • Localization
    • Microsoft.Extensions.Localization
    • Microsoft.Extensions.Localization.Abstractions
  • Logging
    • Microsoft.Extensions.Logging.AzureAppServices
  • Object Pool
    • Microsoft.Extensions.ObjectPool
  • Web Encoders
    • Microsoft.Extensions.WebEncoders
• Remaining in dotnet/extensions for now
  • Caching
    • Microsoft.Extensions.Caching.SqlServer
    • Microsoft.Extensions.Caching.StackExchangeRedis
  • Configuration
    • Microsoft.Extensions.Configuration.NewtonsoftJson
  • Hosting
    • Microsoft.Extensions.Hosting.Systemd
    • Microsoft.Extensions.Hosting.WindowsServices
  • Http Client Factory
    • Microsoft.Extensions.Http.Polly
  • Logging
    • Microsoft.Extensions.Logging.Analyzers (has not been released to NuGet.org as of writing)
    • Microsoft.Extensions.DependencyInjection.Specification.Tests
• No longer shipping in 5.0
  • Microsoft.Extensions.DiagnosticAdapter

Get Started

Follow the Get Started guide for .NET to setup an initial .NET application. Microsoft.Extensions APIs can then be added to the project using the NuGet Package Manager.

How to Engage, Contribute, and Give Feedback

Some of the best ways to contribute are to try things out, file issues, join in design conversations, and make pull-requests.

• Download our latest daily builds
• Build .NET Extensions from source code
• Check out the contributing page to see the best places to log issues and start discussions.

Reporting security issues and bugs

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

Related projects

These are some other repos for related projects:

• .NET Core - a cross-platform, open-source .NET platform
• ASP.NET Core - a .NET Core framework for building web apps
• Entity Framework Core - data access technology

Code of conduct

See CODE-OF-CONDUCT

Community forks

Some parts of this project have been forked by the community to add additional functionality:

McMaster.Extensions.CommandLineUtils

This is a fork of Microsoft.Extensions.CommandLineUtils.

• GitHub: https://github.com/natemcmaster/CommandLineUtils
• NuGet: https://www.nuget.org/packages/McMaster.Extensions.CommandLineUtils