Home Library Learn Downloads Support Community
Sign in | United States - English | |
0 out of 1 rated this helpful - Rate this topic

RoleEnvironment.CurrentRoleInstance Property

Gets a RoleInstance object that represents the role instance in which the code is currently running.

Namespace: Microsoft.WindowsAzure.ServiceRuntime
Assembly: Microsoft.WindowsAzure.ServiceRuntime (in Microsoft.WindowsAzure.ServiceRuntime.dll)
VB
Copy 
'Usage
Dim value As RoleInstance

value = RoleEnvironment.CurrentRoleInstance
C#
C++
VB
Copy 
public static RoleInstance CurrentRoleInstance { get; }
J#
Copy 
/** @property */
public static RoleInstance get_CurrentRoleInstance ()
JScript
Copy 
public static function get CurrentRoleInstance () : RoleInstance

Property Value

Type: Microsoft.WindowsAzure.ServiceRuntime.RoleInstance

An instance of RoleInstance.

A role is a component of an application that performs specific functionality, such as running a website or performing background tasks. A role instance is a running copy of the role in Windows Azure or the Windows Azure Compute Emulator. A role must have endpoints defined to communicate internally and externally. The following code example shows how to retrieve endpoint information for the current role instance:

C#
Copy 

var roleInstance = RoleEnvironment.CurrentRoleInstance; 
foreach (RoleInstanceEndpoint instanceEndpoint in roleInstance.InstanceEndpoints.Values) 
{  
   Trace.WriteLine("Instance endpoint address and port: " + instanceEndpoint.IPEndpoint, "Information");
   Trace.WriteLine("Protocol for the endpoint: " + , instanceEndpoint.Protocol, "Information");
}

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows Vista, Windows 7 and Windows Server 2008

Target Platforms

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ