PerRequestLifetimeManager Class

A LifetimeManager that holds onto the instance given to it during the lifetime of a single HTTP request. This lifetime manager enables you to create instances of registered types that behave like singletons within the scope of an HTTP request. See remarks for important usage information.

Namespace: Microsoft.Practices.Unity
Assembly: Microsoft.Practices.Unity.Mvc (in Microsoft.Practices.Unity.Mvc.dll) Version: 3.0.0.0 (3.0.1304.0)

Syntax

public class PerRequestLifetimeManager : LifetimeManager
'Declaration
Public Class PerRequestLifetimeManager
    Inherits LifetimeManager
public ref class PerRequestLifetimeManager : public LifetimeManager

Remarks

Although the PerRequestLifetimeManager lifetime manager works correctly and can help in working with stateful or thread-unsafe dependencies within the scope of an HTTP request, it is generally not a good idea to use it when it can be avoided, as it can often lead to bad practices or hard to find bugs in the end-user's application code when used incorrectly. It is recommended that the dependencies you register are stateless and if there is a need to share common state between several objects during the lifetime of an HTTP request, then you can have a stateless service that explicitly stores and retrieves this state using the Items collection of the Current object.

For the instance of the registered type to be disposed automatically when the HTTP request completes, make sure to register the UnityPerRequestHttpModule with the web application. To do this, invoke the following in the Unity bootstrapping class (typically UnityMvcActivator.cs):

DynamicModuleUtility.RegisterModule(typeof(UnityPerRequestHttpModule));

Inheritance Hierarchy

System.Object
  Microsoft.Practices.Unity.LifetimeManager
    Microsoft.Practices.Unity.PerRequestLifetimeManager

See Also

PerRequestLifetimeManager Members

Microsoft.Practices.Unity Namespace