RoleEnvironment.RequestRecycle Method ()
Requests that the current role instance be stopped and restarted.
Namespace: Microsoft.WindowsAzure.ServiceRuntime
Assembly: Microsoft.WindowsAzure.ServiceRuntime (in Microsoft.WindowsAzure.ServiceRuntime.dll)
Syntax
public static void RequestRecycle()
public:
static void RequestRecycle()
static member RequestRecycle : unit -> unit
Public Shared Sub RequestRecycle
Exceptions
| Exception | Condition |
|---|---|
| RoleEnvironmentException | The role instance could not be stopped and restarted. |
Remarks
When the RequestRecycle method is called, the load balancer takes the role instance out of the rotation and the normal shutdown cycle is initiated. New requests are not routed to the role instance while it is restarting.
Windows Azure raises the Stopping event and calls the OnStop method where you can run the necessary code to prepare the role instance to be recycled.
See Also
RoleEnvironment Class
Microsoft.WindowsAzure.ServiceRuntime Namespace
Return to top