FormEvents.Save Événement

Référence

Définition

Espace de noms:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Se produit lorsque les commandes Enregistrer ou Enregistrer sous sont utilisées à partir de l’interface utilisateur, ou lorsque les Save() méthodes et SaveAs(String) sont utilisées.

public:
 abstract event Microsoft::Office::InfoPath::SaveEventHandler ^ Save;

public abstract event Microsoft.Office.InfoPath.SaveEventHandler Save;

member this.Save : Microsoft.Office.InfoPath.SaveEventHandler

Public MustOverride Custom Event Save As SaveEventHandler

Type d'événement

SaveEventHandler

Exceptions

InvalidOperationException

Le développeur a tenté de lier l'événement dans un emplacement autre que la méthode InternalStartup.

Exemples

Dans l'exemple suivant, le gestionnaire de l'événement Save vérifie si Field2 est vide, et si ce n'est pas le cas, exécute une opération d'enregistrement. S'il est vide, il affiche un message et annule l'opération d'enregistrement.

public void FormEvents_Save(object sender, SaveEventArgs e)
{
   // Check to see if Field2 is empty.
   XPathNavigator reqField = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:field2", 
      NamespaceManager);
   if(reqField.ToString() == "")
   {
      MessageBox.Show("Field2 is empty.\nYou cannot save the form.");
      e.CancelableArg.Cancel = true;
   }
   else
   {
   // The Dirty property will be set to false if save is successful.
      e.PerformSaveOperation();
      e.CancelableArgs.Cancel = false;
   }
}

Public Sub FormEvents_Save(ByVal sender As Object, _
   ByVal e As SaveEventArgs)
   ' Check to see if Field2 is empty.
   Dim reqField as XPathNavigator = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:field2", _
      NamespaceManager)
   If(reqField.ToString() = "") Then
      MessageBox.Show("Field2 is empty" &amp; vbNewLine &amp; _
         "You cannot save the form.")
      e.CancelableArgs.Cancel = True
   Else
   ' The Dirty property will be set to false if save is successful.
   e.PerformSaveOperation()
   e.CancelableArgs.Cancel = False
   End If
End Sub

Remarques

Important : l’événement Save n’est pas destiné à être instancié par le développeur dans le code de formulaire. Vous devez uniquement ajouter des gestionnaires d’événements pour les événements au niveau du formulaire à partir de l’interface utilisateur du mode création Microsoft InfoPath. Lorsque vous ajoutez un gestionnaire d’événements à votre modèle de formulaire à partir de l’interface utilisateur en mode Création, InfoPath génère du code dans la méthode InternalStartup de votre fichier de code de formulaire à l’aide de la EventManager classe et du membre de la FormEvents classe pour lier l’événement à son gestionnaire d’événements. Pour plus d'informations sur l'ajout de gestionnaires d'événements en mode Création dans InfoPath, consultez Procédure : Ajouter un gestionnaire d'événements.

L’événement Save est déclenché uniquement si l’option Enregistrer à l’aide du code personnalisé est définie dans le modèle de formulaire dans la boîte de dialogue Options de formulaire.

L’événement Save est lié à l’aide du SaveEventHandler délégué.

L’événement Save peut être annulé à l’aide de la CancelableArgs propriété de la SaveEventArgs classe pour définir la propriété Cancel sur true.

L’objetSaveEventArgs, qui est passé en tant que paramètre à un gestionnaire d’événements pour l’événement Save, fournit des propriétés et des méthodes qui peuvent être utilisées pour obtenir le nom de fichier du formulaire, déterminer les status d’enregistrement et effectuer l’opération d’enregistrement.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

Partager via