Export (0) Print
Expand All

HostingEnvironment.RegisterObject Method

Places an object in the list of registered objects for the application.

Namespace:  System.Web.Hosting
Assembly:  System.Web (in System.Web.dll)

[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
public static void RegisterObject(
	IRegisteredObject obj
)

Parameters

obj
Type: System.Web.Hosting.IRegisteredObject

The object to register.

The ApplicationManager class enables methods outside the current application domain to create, manage, and destroy objects inside the current application domain. The RegisterObject method is used to register previously created objects with the hosting environment. Objects registered with the RegisterObject method must implement the IRegisteredObject interface.

To use a registered object, follow these steps:

  1. Create a new instance of your registered object by calling the ApplicationManager.CreateObject method.

  2. Call a type-specific method to initialize your new object. In the initialization method, call the RegisterObject method to add the object to the list of registered objects.

  3. Call the ApplicationManager.GetObject method to return the registered object when required.

  4. When you wish to stop your object, call the ApplicationManager.StopObject method. The ApplicationManager.StopObject method in turn calls the IRegisteredObject.Stop method.

  5. In the IRegisteredObject.Stop method, have your object call the UnregisterObject method.

The following code example is an implementation of a Start method for a registered object. For the full code required to run the example, see the Example section of the IRegisteredObject interface overview topic.

public void Start()
{
  HostingEnvironment.RegisterObject(this);
}

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft