EventManager, classe

Article
04/27/2010

Sert à initialiser et lier des gestionnaires d'événements dans la méthode InternalStartup d'un modèle de formulaire.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans microsoft.office.infopath.dll)

Syntaxe

Public MustInherit Class EventManager

Dim instance As EventManager

public abstract class EventManager

Remarques

La classe EventManager est utilisée par InfoPath pour lier des gestionnaires d'événements pour tous les événements implémentés par les classes ControlEvents, FormEvents et XmlEvents dans la méthode InternalStartup au début de la classe FormCode d'un modèle de formulaire avec code managé. Lors de l'exécution, la méthode InternalStartup est exécutée à l'ouverture du modèle de formulaire afin d'initialiser la liaison de tous les gestionnaires d'événements.

Remarque
Lors de l'ouverture d'un modèle de formulaire dans InfoPath, la méthode InternalStartup est appelée si un utilisateur ouvre le modèle de formulaire. Toutefois, en cas d'ouverture d'un modèle de formulaire dans un navigateur Web à partir de Microsoft Office Forms Server 2007 ou d'une bibliothèque de documents configurée correctement sur Office SharePoint Server 2007 exécutant InfoPath Forms Services, la méthode InternalStartup est appelée uniquement la première fois que l'assembly de logique métier du modèle de formulaire est chargé dans le domaine d'application (AppDomain) sur le serveur. Il s'agit généralement du moment où le premier utilisateur ouvre une instance du modèle de formulaire lors d'une session ou après le recyclage du domaine d'application lors d'une session.

Lors de l'ouverture d'un modèle de formulaire dans InfoPath, la méthode InternalStartup est appelée si un utilisateur ouvre le modèle de formulaire. Toutefois, en cas d'ouverture d'un modèle de formulaire dans un navigateur Web à partir de Microsoft Office Forms Server 2007 ou d'une bibliothèque de documents configurée correctement sur Office SharePoint Server 2007 exécutant InfoPath Forms Services, la méthode InternalStartup est appelée uniquement la première fois que l'assembly de logique métier du modèle de formulaire est chargé dans le domaine d'application (AppDomain) sur le serveur. Il s'agit généralement du moment où le premier utilisateur ouvre une instance du modèle de formulaire lors d'une session ou après le recyclage du domaine d'application lors d'une session.

Exemple

Les exemples ci-dessous illustrent la méthode InternalStartup à partir d'une classe FormCode (fichier FormCode.cs ou FormCode.vb) d'un modèle de formulaire qui lie les gestionnaires d'événements pour l'événement Loading d'un formulaire, l'événement Changed d'un champ et l'événement Clicked d'un contrôle Bouton à l'aide des délégués correspondants.

Important :
La méthode InternalStartup et le code de liaison d'événements correspondant sont générés par InfoPath lors de l'ajout de gestionnaires d'événements à l'aide de diverses commandes de l'interface utilisateur. Ne créez pas la méthode InternalStartup et n'y écrivez pas de code supplémentaire vous-même. Pour plus d'informations sur l'ajout de gestionnaires d'événements à l'aide des commandes de l'interface utilisateur, voir Procédure d'ajout d'un gestionnaire d'événements.

La méthode InternalStartup et le code de liaison d'événements correspondant sont générés par InfoPath lors de l'ajout de gestionnaires d'événements à l'aide de diverses commandes de l'interface utilisateur. Ne créez pas la méthode InternalStartup et n'y écrivez pas de code supplémentaire vous-même. Pour plus d'informations sur l'ajout de gestionnaires d'événements à l'aide des commandes de l'interface utilisateur, voir Procédure d'ajout d'un gestionnaire d'événements.

public void InternalStartup()
{
   EventManager.FormEvents.Loading += 
      new LoadingEventHandler(FormEvents_Loading);
   EventManager.XmlEvents["/my:myFields/my:Name"].Changed += 
      new XmlChangedEventHandler(Name_Changed);
   ((ButtonEvent)EventManager.ControlEvents["MyBtn"]).Clicked += 
      new ClickedEventHandler(MyBtn_Clicked);
}

Private Sub InternalStartup(ByVal sender As Object, _
   ByVal e As EventArgs) Handles Me.Startup
   AddHandler EventManager.FormEvents.Loading, _
      AddressOf FormEvents_Loading
   AddHandler EventManager.XmlEvents("/my:myFields/my:Name").Changed, _
      AddressOf Name_Changed
   AddHandler DirectCast(EventManager.ControlEvents("MyBtn"), _
      ButtonEvent).Clicked, AddressOf MyBtn_Clicked
End Sub

Hiérarchie d'héritage

System.Object
Microsoft.Office.InfoPath.EventManager

Sécurité des threads

Les membres statiques publics de ce type (Shared en Visual Basic) sont sécurisés au niveau des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.

Voir aussi

Référence

Membres EventManager
Microsoft.Office.InfoPath, espace de noms

Partager via