Partager via

Ajouter un gestionnaire d’événements

  • Article

Cette rubrique décrit les procédures permettant d'ajouter des gestionnaires d'événements à un modèle de formulaire Microsoft InfoPath avec code managé avec Visual Studio 2012. Pour ajouter un gestionnaire d’événements à un modèle de formulaire, commencez par ouvrir le modèle de formulaire dans le Designer InfoPath, puis sélectionnez la commande d’interface utilisateur appropriée pour l’événement pour lequel vous souhaitez écrire du code. Après avoir sélectionné la commande d’un événement dans le Designer InfoPath, le focus bascule automatiquement vers le gestionnaire d’événements squelette pour cet événement dans l’éditeur de code Visual Studio 2012.

Importante

Vous devez toujours utiliser l’interface utilisateur InfoPath Designer pour ajouter un gestionnaire d’événements. L’ajout d’un gestionnaire d’événements avec l’interface utilisateur génère du code de liaison d’événements dans la méthode InternalStartup du fichier FormCode.cs ou FormCode.vb dans votre projet de modèle de formulaire. Vous ne devez pas créer la méthode InternalStartup ou y ajouter vous-même du code supplémentaire.

Ajout d'un gestionnaire d'événement pour l'événement Click d'un contrôle Bouton

  1. Ouvrez le modèle de formulaire dans le Designer InfoPath, puis ajoutez un contrôle Button au formulaire.

  2. Cliquez sur le bouton, puis sous l'onglet Propriétés du ruban, cliquez sur Code personnalisé.

    Le squelette de gestionnaire d'événements de l'événement Clicked est activé dans l'éditeur de code Visual Studio 2012.

Ajout d'un gestionnaire d'événements pour l'événement Changing, Validating ou Changed d'un champ ou d'un groupe

  1. Ouvrez le modèle de formulaire dans le Designer InfoPath.

  2. Cliquez avec le bouton droit de la souris sur un contrôle d'entrée de données lié au champ ou au groupe, par exemple un contrôle Zone de texte.

  3. Pointez vers Programmation, puis cliquez sur l'événement pour lequel vous souhaitez créer un gestionnaire d'événements. Le squelette de gestionnaire d'événements de l'événement Changing , Validating ou Changed dans l'éditeur de code Visual Studio 2012.

    Remarque

    [!REMARQUE] La commande servant à créer un gestionnaire d'événements pour l'événement Changing n'est pas disponible si le paramètre de compatibilité pour le modèle de formulaire st défini sur Formulaire de navigateur Web. L'événement Changing n'est pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents dans Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d'événements pour l'événement Changing, vous devez modifier le paramètre de compatibilité sur Éditeur InfoPath du Concepteur InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.

Ajout d'un gestionnaire d'événements pour les événements Loading, ViewSwitched, ContextChanged et Sign d'un formulaire

  1. Ouvrez le modèle de formulaire dans le Designer InfoPath.

  2. Sous l'onglet Développeur du ruban, cliquez sur l'événement de formulaire pour lequel vous souhaitez écrire un gestionnaire d'événements.

    Le focus bascule vers le gestionnaire d’événements squelette pour l’événement Loading, ViewSwitched, ContextChanged ou Sign dans l’éditeur de code Visual Studio 2012.

    Remarque

    [!REMARQUE] Les commandes servant à créer un gestionnaire d'événements pour l'événement ContextChanged ou Sign ne sont pas disponibles pour le paramètre de compatibilité du modèle de formulaire est défini sur Formulaire de navigateur Web. Ces événements ne sont pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d’événements pour l’événement ContextChanged ou Sign, vous devez remplacer le paramètre de compatibilité par InfoPath Rédacteur Formulaire dans le Designer InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.

Ajout d'un gestionnaire d'événements pour l'événement Submit d'un formulaire

  1. Ouvrez le modèle de formulaire dans le Designer InfoPath.

  2. Cliquez sur l’onglet Fichier , sur Envoyer à sous l’onglet Informations , puis sur Options d’envoi.

  3. Activez la case à cocher Autoriser les utilisateurs à envoyer ce formulaire, cliquez sur Effectuer une action personnalisée à l'aide du code, puis sur Modifier le code.

    Le squelette de gestionnaire d'événements de l'événement Submit est activé dans l'éditeur de code Visual Studio 2012.

Ajout d'un gestionnaire d'événements pour l'événement Save d'un formulaire

  1. Ouvrez le modèle de formulaire dans le Designer InfoPath.

  2. Cliquez sur l'onglet Fichier, puis cliquez sur Options de formulaire sous l'onglet Infos.

  3. Cliquez sur la catégorie Enregistrer, activez la case à cocher Enregistrer au moyen d'un code personnalisé, puis cliquez sur Modifier.

    Le squelette de gestionnaire d'événements de l'événement Save est activé dans l'éditeur de code Visual Studio 2012.

    Remarque

    [!REMARQUE] La case à cocher Enregistrer au moyen d'un code personnalisé n'est pas disponible si le paramètre de compatibilité du modèle de formulaire est défini sur InfoPath Forms Services. L'événement Save n'est pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents dans Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d’événements pour l’événement Save, vous devez remplacer le paramètre de compatibilité par InfoPath Rédacteur Form dans le Designer InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, cliquez sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.

Ajout d'un gestionnaire d'événements pour l'événement VersionUpgrade d'un formulaire

  1. Ouvrez le modèle de formulaire dans le Designer InfoPath.

  2. Cliquez sur l'onglet Fichier, puis cliquez sur Options de formulaire sous l'onglet Infos.

  3. Cliquez sur la catégorie Contrôle de version, sélectionnez Utiliser un événement personnalisé dans la liste déroulante Mettre à jour les formulaires existants, puis cliquez sur Modifier.

    Le squelette de gestionnaire d'événements de l'événement Save est activé dans l'éditeur de code Visual Studio 2012.

Ajout d'un gestionnaire d'événements pour l'événement Merge d'un formulaire

  1. Ouvrez le modèle de formulaire dans le Designer InfoPath.

  2. Cliquez sur l'onglet Fichier, puis cliquez sur Options de formulaire sous l'onglet Infos.

  3. Cliquez sur la catégorie Avancé, activez la case à cocher Activer la fusion de formulaires, activez la case à cocher Fusionner à l'aide d'un code personnalisé cliquez sur Modifier.

    Le squelette de gestionnaire d'événements de l'événement Merge est activé dans l'éditeur de code Visual Studio 2012.

    Remarque

    [!REMARQUE] La case à cocher Fusionner à l'aide d'un code personnalisé n'est pas disponible si le paramètre de compatibilité du modèle de formulaire est défini sur InfoPath Forms Services. L'événement Merge n'est pas pris en charge dans la logique métier des modèles de formulaires publiés dans les bibliothèques de documents dans Microsoft SharePoint Server 2010 avec InfoPath Forms Services. Pour créer un gestionnaire d’événements pour l’événement Merge, vous devez remplacer le paramètre de compatibilité par InfoPath Rédacteur Form dans le Designer InfoPath. Pour cela, cliquez sur l'onglet Fichier, cliquez sur Options de formulaire, cliquez sur Compatibilité, puis définissez Type de formulaire sur Formulaire de l'Éditeur InfoPath.

Voir aussi

Procédure : Création d’un modèle de formulaire de base avec code