v6.3.0

• Modules can now be registered conditionally using an OnlyIf clause. (#1235, #1272)
• Delegate factories will no longer allow parameters with the name value to inject by name as that's a reserved word in property setter methods. (#1275)
• IAsyncDisposable instances that have not been activated are correctly disposed when the scope is disposed. (#1285)
• There are now generic overloads for TryResolveNamed and TryResolveKeyed. (#1263, #1287 - thanks @v0idzz!)
• Fixed performance regression in assembly scanning with respect to compiler generated types. (#1289 - thanks @RogerKratz!)

v6.2.0

Resolved issues / PRs:

• #215: You can now use RegisterAssemblyOpenGenericTypes to do assembly scanning and register open generics! (#1232 / #1246)
• #1211: Added ConfigurePipeline to IComponentRegistration to allow easier registration pipeline modification (related to #1211)
• #1238: Static and constructors are no longer considered for reflection (#1239)
• #1252: Behavior of ConcurrentBag on different platforms resulted in a memory leak in OnActivated usage; we now flush the ConcurrentBag of registrations on disposal of a lifetime scope (#1257)

v6.1.0

• Added direct support for .NET 5.
• Internals update to allow more dynamic reconfiguration of resolve pipelines.
• Fix #1204: Decorated instances marked with AllowCircularDependencies should now get properties injected correctly.
• Fix #1226: Constructor binders correctly detect ref parameters.

v6.0.0

Version 6.0.0 represents a major update in the Autofac internals. While every effort has been made to ensure code using version 5.x will continue to work exactly as you expect, you should be aware of the breaking changes and test things out. For the majority case, things should just continue to work; breaking changes are primarily in more rare advanced usage scenarios.

Check out the release blog post! Also, the documentation has been updated and is ready!

⚠️ Starting with Autofac 6.0, we now only target netstandard20 and netstandard21; we have removed the explicit target for net461.

The impact to you is that, while Autofac will still work on .NET Framework 4.6.1 as it did before, we strongly encourage you to upgrade to .NET Framework 4.7.2 or higher, as per the .NET Standard Documentation, to avoid any of the known dependency issues when using .NET Standard packages in .NET Framework 4.6.1.

New Features

There are a lot of new features, but the big ones are here. Other features and fixes will be outlined in the Issues section, below.

• Pipelines: This is the major change in Autofac v6 - all resolution activities internally now flow through pipelines, similar to how ASP.NET Core requests flow through pipelines. This allows for better customization in how things get resolved as well as enabling support for more new features.
• Composites: The composite pattern allows a collection of objects to be treated as though it's a single object.
• Diagnostics: Autofac v6 adds support for DiagnosticSource diagnostics. The core Autofac package ships with a default text-based diagnostic tracer and the new Autofac.Diagnostics.DotGraph package adds graphic tracing using DOT and Graphviz.
• Generic Delegate Registrations: You can now register an open generic associated with a delegate/lambda expression, allowing you to provide a custom factory to resolve generics just like you do with non-generic types.
• Concurrency Performance Improvements: We focused a lot on performance and have removed a lot of locking. In some highly-concurrent cases, we've seen a 4x speed increase.

Issues and PRs

The following issues have been addressed in v6:

• #718: Circular dependency support using property injection and relationships like Lazy<T> should now work.
• #788: DOT graph support has been added via the Autofac.Diagnostics.DotGraph package.
• #798 / #1148: Circular dependency handling uses the .NET runtime to check stack depth when checking for circular dependencies rather than using a fixed stack depth.
• #828: The ILifetimeScope.LifetimeScopeEnding event is raised and completes before the scope is disposed.
• #970: The composite pattern is now supported.
• #1069 / #1172: Core Autofac events are now async-friendly.
• #1120 / #1128: ContainerBuilder is now sealed.
• #1123: Explicitly injected properties can now be declared using an expression.
• #1126 / #1169: Diagnostics are handled via DiagnosticSource.
• #1162: A new "pooled" lifetime type has been added via the Autofac.Pooling package.

Breaking Changes

We'll do our best to keep an upgrade guide with breaking changes available and up to date. We're pretty sure we caught them all, but if you find a gotcha, let us know on the Documentation repo.

A summary of the breaking changes is as follows:

• net461 is no longer targeted; Autofac now targets netstandard2.0 and netstandard2.1.
• Activation events are no longer exposed - this all happens through middleware now.
  • If you were using an Autofac module to attach to activation events and inject parameters, similar to the way the log4net module example is shown in the documentation, this now needs to happen through middleware. The log4net module example has been updated to show you the new way it works.
  • RegistrationBuilder.RegistrationData no longer exposes activation handlers. The CoreEventMiddleware is the source of events now.
  • IComponentRegistration no longer exposes activation events. The CoreEventMiddleware is the source of events now.
• Interface changes:
  • IConstructorSelector implementations need to switch to use BoundConstructor instead of ConstructorParameterBinding.
  • IRegistrationSource implementations need to update the RegistrationsFor method signature.
  • IInstanceActivator implementations no longer have an ActivateInstance method and instead have a ConfigurePipeline method.
  • IComponentRegistry no longer supplies a DecoratorsFor method to check decorators. Use IComponentRegistry.ServiceMiddlewareFor instead.
  • The ResolveRequest constructor now takes a ServiceRegistration instead of an IComponentRegistration.
• ContainerBuilder is now sealed.
• Autofac is no longer marked CLS compliant. The Microsoft DiagnosticSource and related entities we (and ASP.NET Core, and others) use for diagnostics is not CLS compliant so Autofac can't be, either.

Still Todo

We're working hard to get all of the ~25 integration packages pushed to NuGet as quickly as we can, so please bear with us while we get these sorted.

Some of this is sitting in branches ready to go, other things need to be done now that we have this core package out there.

If your favorite integration isn’t ready yet, we’re doing our best. Rather than filing "When will this be ready?" issues, consider pull requests with the required updates.

v5.2.0

Fixes:

• #1108: OnActivating() and OnActivated() should now act more consistently with decorators than it previously did.
• #1113: Lifetime scope discrepancies between different decorated implementations should no longer cause problems with IEnumerable<T> resolutions.

Thanks to @VonOgre for a ton of great work on this one.

v5.1.4

#1111 / #1102 - Minor update to handling of provided instances with OnRelease.

v5.1.3

Issues resolved:

• #1089: Owned instances now allow for async disposal.
• #1094: InstancePerOwned now works correctly with keyed registrations.
• #1099: ACTNARS can now resolve generic types with abstract type arguments.
• #1102: Provided instances should now have OnRelease called when the container is disposed regardless of whether the instances themselves were resolved from the container.
• #1107: The new() generic type constraint should now be correctly handled in open generic registrations.

v5.1.2

• Fix #1085 - StackOverflowException thrown with circular property dependencies

v5.1.1

Replaced missing constructor on ResolveRequest to fix accidental break in 5.1.0.

v5.1.0

• Update NuGet package to use new icon
• Cache the implementations of a ServiceRegistrationInfo until the implementations change
• Fix #963 - Partially decorating service implementing multiple interfaces throws
• Fix #1073 - Always lock when getting an initialized ServiceRegistrationInfo
• Fix #1077 - Keep raising 'Registered' and 'RegistrationSourceAdded' events after the 'ComponentRegistry' has been built