Duration (Pacific Standard Time):
To (Pacific Standard Time):
  • None
User Action:
  • None

RoleEntryPoint.OnStop Method ()


Runs code when a role instance is to be stopped.

Namespace:   Microsoft.WindowsAzure.ServiceRuntime
Assembly:  Microsoft.WindowsAzure.ServiceRuntime (in Microsoft.WindowsAzure.ServiceRuntime.dll)

Public Overridable Sub OnStop

Override the OnStop method to run code when the role instance is stopped. The following code example shows how to override the OnStop method:

No code example is currently available or this language may not be supported.
System_CAPS_note Note

Code running in the OnStop method has 5 minutes to finish when it is called for reasons other than a user-initiated shutdown. After this time elapses, the process is terminated, so you must make sure that code in the OnStop method can run quickly or tolerates not running to completion.

Once the OnStop method has finished executing, the role will be stopped. If other code requires time to exit gracefully you should keep the OnStop thread busy until execution is complete.

A web role can include termination code in the ASP.NET Application_End method instead of the OnStop method. The Application_End method is called before the Stopping event is raised or the OnStop method is called. For more information about the Application_End method, see ASP.NET Application Life Cycle Overview for IIS 5.0 and 6.0 or ASP.NET Application Life Cycle Overview for IIS 7.0.

Return to top