Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

RoleEnvironment.Changed Event

Occurs after a change to the service configuration is applied to the running instances of a role.

Namespace: Microsoft.WindowsAzure.ServiceRuntime
Assembly: Microsoft.WindowsAzure.ServiceRuntime (in Microsoft.WindowsAzure.ServiceRuntime.dll)
VB
Copy 
'Usage
Dim handler As EventHandler(Of RoleEnvironmentChangedEventArgs)

AddHandler RoleEnvironment.Changed, handler
C#
C++
VB
Copy 
public static event EventHandler<RoleEnvironmentChangedEventArgs> Changed
J#
Copy 
/** @event */
public static void add_Changed (EventHandler<RoleEnvironmentChangedEventArgs> value)

/** @event */
public static void remove_Changed (EventHandler<RoleEnvironmentChangedEventArgs> value)
JScript
Copy

The Changed event and the Changing event are used together to identify and manage configuration changes to the service model. The RoleEnvironmentChangedEventArgs object provides the settings that were changed in the service configuration. You can use the Changing event to decide when the changes are applied.

The following code example shows how to write the list of configuration changes that were made to the role instance when the Changed event is raised:

C#
Copy 

public override bool OnStart()
{
   RoleEnvironment.Changed += RoleEnvironmentChanged;
  
   return base.OnStart();
}

private void RoleEnvironmentChanged(object sender, RoleEnvironmentChangedEventArgs e)
{
   // Get the list of configuration changes
   var settingChanges = e.Changes.OfType<RoleEnvironmentConfigurationSettingChange>();
      
   foreach (var settingChange in settingChanges) 
   {
      Trace.WriteLine("Setting: " + settingChange.ConfigurationSettingName, "Information");
   }
}

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
This event is raised on its own thread.
Please take into account his event is raised on its own thread and not on the subscribing thread.
History