Was this page helpful?
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

RoleEntryPoint.OnStart Method ()


Runs code that initializes a role instance.

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

Public Overridable Function OnStart As Boolean

Return Value

Type: System.Boolean

true if initialization succeeds; otherwise, false. The default return value is true.

Override the OnStart method to run initialization code for your role. The following code example shows how to override the OnStart method:

public class WorkerRole : RoleEntryPoint
   public override bool OnStart()
         // Add initialization code here
      catch (Exception e)
         Trace.WriteLine("Exception during OnStart: " + e.ToString());
         // Take other action as needed.

      return base.OnStart();

Before the OnStart method returns, the status of the role instance is set to Busy and the instance is not available through the load balancer.

If the OnStart method returns false, the role instance is immediately stopped. If the method returns true, Windows Azure starts the role by calling the Run method. In general, you should avoid returning false from the OnStart method.

A web role can include initialization code in the ASP.NET Application_Start method instead of the OnStart method. The Application_Start method is called after the OnStart method. For more information about the Application_Start 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
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft