VENTES: 1-800-867-1389

Utiliser l'événement RoleEnvironment.Changing

Mis à jour: novembre 2013

L'événement Changing vous permet de gérer la façon dont une instance de rôle répond à une modification de configuration. À l'aide de l'événement Changing, une instance peut répondre à une modification de configuration de l'une des façons suivantes :

  • L'instance peut accepter la modification de configuration pendant qu'elle s'exécute, sans être mise hors connexion.

  • L'instance peut annuler l'événement Changing. Dans ce cas, Windows Azure met l'instance hors connexion, applique la modification de configuration, puis remet l'instance en ligne.

En annulant l'événement Changing, vous avez la garantie que l'instance suit une séquence d'arrêt ordonnée et qu'elle est mise hors connexion avant que la modification de configuration ne soit appliquée. Pendant le processus d'arrêt, Windows Azure déclenche l'événement Stopping, puis exécute du code dans la méthode OnStop.

noteRemarque
Vous disposez d'un délai limité pour accepter ou annuler l'événement Changing. Assurez-vous que votre gestionnaire d'événements peut retourner les informations en temps voulu.

Vous pouvez annuler l'événement Changing dans les cas suivants :

  • Votre instance de rôle ne prend pas en charge les modifications de configuration en cours d'exécution. Elle nécessite un recyclage pour permettre l'application de la modification.

  • Votre instance de rôle exécute un travail qui ne doit pas être perturbé par une modification de configuration. Elle doit passer par la séquence d'arrêt pour permettre l'application de la modification.

La classe RoleEnvironmentChangingEventArgs fournit une propriété Changes qui retourne une collection de modifications de configuration qui sont sur le point d'être appliquées à l'instance. Les objets de cette collection correspondent à l'un des types suivants :

noteRemarque
Vous pouvez voir le nom du paramètre de configuration en cours de modification, mais vous ne pouvez pas accéder à la nouvelle valeur tant que l'événement Changed n'est pas déclenché.

Pour définir le gestionnaire d'événements

  1. Ouvrez le fichier source où vous gérez les modifications de configuration.

  2. Vérifiez que le projet référence le fichier Microsoft.WindowsAzure.ServiceRuntime.dll et que l'instruction using suivante est ajoutée au fichier :

    using Microsoft.WindowsAzure.ServiceRuntime;
    
  3. Ajoutez le code suivant à la méthode OnStart pour spécifier le gestionnaire d'événements :

    
    public override bool OnStart()
    {
       RoleEnvironment.Changing += RoleEnvironmentChanging;
                
       return base.OnStart();
    }
    
  4. Ajoutez la méthode suivante du gestionnaire d'événements au fichier source :

    
    private void RoleEnvironmentChanging(object sender, RoleEnvironmentChangingEventArgs e)
    {
       // Add code for handling changes
    }
    
  5. Enregistrez le fichier.

Voir aussi

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft