Release Notes

This release can be downloaded using NuGet.

The most prominent improvements are:

• the availability of a .NET Standard 2.0 version of the Simple Injector core library, which limits the number of installed NuGet packages on machines
• support for List<T> and Collection<T> dependencies.

Features and improvements

Simple Injector core library

• #559 NuGet package now contains a.NET Standard 2.0 version. Special thanks to @borrrden for this.
• #545 List<T> and Collection<T> dependencies are now supported out of the box. Any collection, registered using Collection.Register can now be injected and resolved as either a List<T> or Collection<T>.
• #369 In case Simple Injector throws an exception explaining that the container is either locked or disposed, the .NET Standard 2.0 version now includes the stack trace that caused the container to either be locked or disposed. This information was already available in .NET 4.0 and .NET 4.5 versions.

Simple Injector ASP.NET Core integration

• #585 AutoCrossWireAspNetComponents overload added that accepts IServiceProvider.

Bug fixes

Simple Injector core library

• #627 Registration of collections of variant types where implementation type is unknown to Simple Injector, especially when registering Registration instances through Collection.Register and Collection.Append failed.

Simple Injector Web API integration package

• #628 Use of EnableHttpRequestMessageTracking under .NET <= 4.6.x could cause a memory leak.

Simple Injector ASP.NET Core integration

• #588 SimpleInjectorControllerActivator will not resolve unregistered controllers from ASP.NET Core anymore.

Release Notes

This release can be downloaded using NuGet.

The major theme of this release is to improve usability by introducing new overloads to existing registration methods and by grouping all the collection registration methods.

The grouping of collection registration methods was started in release v4.1 and had to be done gradually from minor release to minor release to prevent having too many changes at once for existing users. This release ends this refactoring phase; all methods concerning the creation, appending and registration of collections are now available by calling container.Collection., e.g. container.Collection.Register.

Overloads have been added to Collection.Create, Collection.Append, Collection.Register and GetTypesToRegister to make it easier to work with these methods. Among other things, this included the addition of generic methods and methods containing a params array.

Features and improvements

Simple Injector core library

• #548 Added Collection.Create(params Assembly[]) and Collection.CreateRegistration(params Assembly[]) overloads
• #547 Renamed Collection.AppendTo to Collection.Append. Old methods marked [Obsolete].
• #546 Added Collection.Append<TService, TImplementation>() overload.
• #552 Added RegisterConditional<TService>(Registration, Predicate<PredicateContext>) overload.
• #551 Added GetTypesToRegister overloads.
• #541 Renamed RegisterCollection overloads to Collection.Register. Old methods are marked [Obsolete].
• #542 Added `Collection.Register(params) overloads.
• #556 Renamed Container.Collections to Container.Collection. Old property marked [Obsolete].

Release Notes

Simple Injector can be downloaded using NuGet.

Bug fixes

Simple Injector core library

• Container.Collections renamed to Container.Collection. #556.

Release Notes

Simple Injector can be downloaded using NuGet.

Bug fixes

Simple Injector core library

• Container.Collections renamed to Container.Collection. #556.

Release Notes

Simple Injector can be downloaded using NuGet.

Bug fixes

Simple Injector core library

• Calling RegisterDecorator on short-lived containers causes memory-leak #532

Release Notes

Simple Injector can be downloaded using NuGet.

Bug fixes

Simple Injector core library

• Calling RegisterDecorator on short-lived containers causes memory-leak #532

Release Notes

Simple Injector v4.2 can be downloaded using NuGet.

Features and improvements

Simple Injector core library

• Reintroduction of ambient-less scoping #532

Release Notes

Simple Injector v4.1 can be downloaded using NuGet.

This release contains several smaller improvements and bug fixes to the core library and its integration packages. Most prominent changes are:

• In our constant effort to improve the API, we obsoleted some methods and replaced them with other methods with the same behavior:
  • Container.RegisterSingleton(T) became Container.RegisterInstance(T)
  • Container.RegisterSingleton(Type, object) became Container.RegisterInstance(Type, object)
  • AdvancedExtensions.AppendToCollection overloads became Container.Collections.AppendTo
  • The WcfOperationLifestyle became obsolete. AsyncScopedLifestyle should be used instead.
• The WCF Integration package is now compatible with the new async/await paradigm, which allows you to make your WCF service methods asynchronous. This requires the use of AsyncScopedLifestyle, and as a consequence, the integration package is now only compatible with .NET 4.5 and up.
• Two improvements in the ASP.NET Core integration library simplify cross-wiring and the addition of middleware. These packages now require ASP.NET Core 2.0 or up.

Features and improvements

Simple Injector core library

• RegisterSingleton(T) and RegisterSingleton(Type, object) overloads renamed to RegisterInstance #469
• Overloads added to Container.Register and Container.RegisterSingleton to simplify batch-registration on a single assembly #486
• Allow created disposable instances to be retrieved from their Scope #478
• Simplified working with subsets of collections #517

SimpleInjector.Integration.AspNetCore

• UseMiddleware(Container) extension method added to ASP.NET Core integration package to simplify adding middleware #513
• Simplified cross-wiring by introducing a new AutoCrossWireAspNetComponents() extension method #442

SimpleInjector.Integration.Wcf

• SimpleInjector.Integration.Wcf now supports async WCF service methods #447

Bug fixes

Simple Injector core library

• Decorator registration didn't check whether supplied type contained generic type parameters, making the registration fail silently #394
• RegisterDecorator overload that accepts lifestyle was missing generic constraints #499

Release Notes

Simple Injector v4 is available through Nuget. For more background information about this release and a general overview, please read the blog post.

Before you upgrade to v4.0, please make sure you upgrade your application to the latest 3.x version of Simple Injector first.

Features and improvements

Simple Injector core library

• ThreadScopedLifestyle added to core library as replacement of LifetimeScopeLifestyle. This is purely a name change, it behaves identical to the old LifetimeScopeLifestyle. The SimpleInjector.Extensions.LifestyleScoping package has been deprecated. (fixes #299)

• AsyncScopedLifestyle added to core library as replacement of ExecutionContextScopeLifestyle. This is purely a name change, it behaves identical to the old ExecutionContextScopeLifestyle. The SimpleInjector.Extensions.ExecutionContextScoping package has been deprecated. (fixes #299)

• TypesExtensions class added with useful extension methods on Type: ToFriendlyName,
  IsClosedTypeOf, GetClosedTypeOf and GetClosedTypesOf methods. (fixes #358)

• Container.AddRegistration(Registration) method added. (fixes #367)

• Lifestyle.CreateHybrid overloads added for ScopedLifestyles that remove the need to supply
  an lifestyleSelector delegate. (fixes #341)

• InstanceProducer.FromExpression() added to simplify wrapping Expression instances. (fixes #346)

• Stack trace added to exception that gets thrown when container got disposed. (fixes #368)

• Clear exception is thrown when invalid Expression is passed on to
  ExpressionBuildingEventArgs.Expression. (fixes #354)

• Improved exception message when registering generic types with type constraints while in
  overriding mode. (fixes #384)

• Improved exception message thrown when RegisterCollection is called twice. (fixes #378)

SimpleInjector.Integration.AspNetCore

• GetRequestService and GetRequiredRequestService extension methods added for IApplicationBuilder to simplify resolving instances from the ASP.NET configuration system, while
  their lifestyle is preserved. See the ASP.NET Core integration guide for more information.

SimpleInjector.Packaging

• GetPackagesToRegister extension method added to simplify retrieving packages.

Breaking changes

Simple Injector core library

• Registration instances will now get cached to prevent torn lifestyles. (fixes #219)

• Short Circuited Dependency warning will now go off as well for transient registrations. (fixes #248)

• Container.RegisterInitializer(Action<InstanceInitializationData>, Predicate<InitializationContext>)
  replaced with RegisterInitializer(Action<InstanceInitializationData>, Predicate<InitializerContext>)
  method. (fixes #348)

• IConstructorResolutionBehavior.GetConstructor(Type, Type) signature changed to
  GetConstructor(Type). (fixes #345)

• ILifestyleSelectionBehavior.SelectLifestyle(Type, Type) signature changed to
  SelectLifestyle(Type). (fixes #345)

• IDependencyInjectionBehavior.BuildExpression method replace with
  GetInstanceProducer(InjectionConsumerInfo, bool) that returns an InstanceProducer (fixes #346)

• IPropertySelectionBehavior.SelectProperty(Type serviceType, PropertyInfo) replaced with
  SelectProperty(Type implementationType, PropertyInfo) method. (fixes #348)

• Lifestyle.CreateRegistration<TService, TImplementation>(Container) signature changes to CreateRegistration(Container). (fixes #345)

• Lifestyle.CreateRegistration(Type, Type, Container) signature changes to
  CreateRegistration(Type, Container). (fixed #345)

• Lifestyle.CreateRegistrationCore<TService, TImplementation>(Container) signature changes to
  CreateRegistrationCore(Container). (fixes #345)

• Lifestyle.Length property made public to simplify creating custom lifestyles. (fixes #245)

• ExpressionBuildingEventArgs.RegisteredServiceType removed. (fixes #348)

• InjectionConsumerInfo.ServiceType removed. (fixes #348)

• Registration.BuildTransientExpression<TService, TImplementation>() signature changed to
  BuildTransientExpression(). (fixes #345)

• Registration.BuildTransientDelegate<TService, TImplementation>() signature changed to
  BuildTransientDelegate(). (fixes #345 / #348)

SimpleInjector.Extensions.LifetimeScoping

• This package has been deprecated and will no longer be maintained. All functionality has been merged into the core library. (fixes #299)
• LifetimeScopeLifestyle has been deprecated. Users should use the new SimpleInjector.Lifestyles.ThreadScopedLifestyle. (fixes #299)

SimpleInjector.Extensions.ExecutionContextScoping

• This package has been deprecated and will no longer be maintained. All functionality has been merged into the core library. (fixes #299)
• ExecutionContextScopeLifestyle has been deprecated. Users should use the new SimpleInjector.Lifestyles.AsyncScopedLifestyle. (fixes #299)

SimpleInjector.Integration.AspNetCore

• AspNetRequestLifestyle has been deprecated. Users should use the new SimpleInjector.Lifestyles.AsyncScopedLifestyle.
• UseSimpleInjectorAspNetRequestScoping extension method for IApplicationBuilder has been deprecated. Users should now use the overload for IServiceCollection instead. See the integration guide for more information.

SimpleInjector.Integration.Wcf

• SimpleInjectorWcfExtensions methods that were deprecated in v3 have now been removed completely. (fixes #305)
• SimpleInjectorWcfExtensions.RegisterPerWcfOperation marked obsolete.
• WcfOperationLifestyle methods that were deprecated in v3 have now been removed completely. (fixes #326)
• RegisterPerWcfOperation and GetCurrentWcfOperationScope marked with Obsolete(true) causing them to trigger. (fixes #304)

SimpleInjector.Integration.Web

• SimpleInjectorWebExtensions and WebRequestLifestyle methods that were deprecated in v3 have now been removed completely. (fixes #326)
• RegisterPerWebRequest marked with Obsolete(true). (fixes #304)

SimpleInjector.Integration.Web.Mvc

• SimpleInjectorMvcExtensions methods that were deprecated in v3 have now been removed completely. (fixes #305)

SimpleInjector.Integration.WebApi

• WebApiRequestLifestyle has been deprecated. Users should use the new SimpleInjector.Lifestyles.AsyncScopedLifestyle. (fixes #331)
• RegisterWebApiRequest m with Obsolete(true) causing it to trigger a compile error. (fixes #304)

SimpleInjector.Packaging

• RegisterPackages(Container) method marked obsolete. The overload that accepts a list of Assembly instances should be used instead. (fixes #372)

Bug fixes

• Prevented RegisterConditional predicates from always being called twice. (fixes #346)
• Allowed properties to be injected on conditional registrations, in case custom property injection behavior is applied. (fixes #383)
• Open-generic abstractions with a "new()" type constraint would be incorrectly flagged as
  conditional, making it impossible to replace those registrations. (fixes #387)