Partager via


SubmitToHostConnection - Classe

Représente une connexion permettant d'envoyer des données à un environnement d'hébergement.

Hiérarchie d’héritage

System.Object
  Microsoft.Office.InfoPath.DataConnection
    Microsoft.Office.InfoPath.SubmitToHostConnection

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

Syntaxe

'Déclaration
Public MustInherit Class SubmitToHostConnection _
    Inherits DataConnection
'Utilisation
Dim instance As SubmitToHostConnection
public abstract class SubmitToHostConnection : DataConnection

Remarques

Ce type de connexion est utilisé dans un modèle de formulaire est ouvert par une application qui héberge l'environnement en tant que contrôle d'édition de formulaires InfoPath. Pour plus d'informations sur l'hébergement d'InfoPath en tant que contrôle, y compris des informations sur la création d'une méthode pour gérer l'événement pour l'envoi d'un formulaire dans le code de votre application hôte, consultez l'article intitulé d'hébergement de l'environnement d'édition du formulaire InfoPath dans une Application de formulaire Windows personnalisée sur MSDN.

Pour créer une connexion de données qui permet d'envoyer des données à un environnement d'hébergement pouvant être référencé à partir de la logique métier dans un modèle de formulaire, utilisez la commande Connexions de données de l'onglet Données du ruban. Pour plus d'informations sur la création d'un gestionnaire d'événements à exécuter lors du déclenchement de l'événement Submit, voir Procédure : ajouter un gestionnaire d'événements.

Exemples

L'exemple ci-dessous illustre un modèle à suivre pour écrire du code exécutant des actions personnalisées dans la logique métier d'un modèle de formulaire avant l'envoi du formulaire.

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   // Get the data connection defined in the form template from the 
   // DataConnections collection and cast to the SubmitToHostConnection
   // type.
   SubmitToHostConnection submitConnection = 
      (SubmitToHostConnection)(DataConnections["MyHostConnection"]);

   // Write code here to do custom actions that are not 
   // supported by rules or other declarative settings.  

   // Execute the submit operation against the connection.
   submitConnection.Execute();

}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArg)
   ' Get the data connection defined in the form template from the
   ' DataConnections collection and cast to the SubmitToHostConnection
   ' type.
   Dim submitConnection As SubmitToHostConnection = _
      DirectCast(DataConnections("MyHostConnection"), _
      SubmitToHostConnection)

   ' Write code here to do custom actions that are not 
   ' supported by rules or other declarative settings.

   ' Execute the submit operation against the connection.
   submitConnection.Execute()
End Sub

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

SubmitToHostConnection - Membres

Microsoft.Office.InfoPath - Espace de noms