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 ouvert par une application qui héberge l'environnement d'édition de formulaires InfoPath en tant que contrôle. Pour plus d'informations sur l'hébergement d'InfoPath en tant que contrôle, notamment pour des informations sur la création d'une méthode permettant de gérer l'événement d'envoi d'un formulaire dans le code de l'application hôte, voir l'article « Hosting the InfoPath Form Editing Environment in a Custom WinForm Application » (Hébergement de l'environnement d'édition de formulaires InfoPath dans une application de formulaire Windows personnalisée) sur le Portail pour les développeurs InfoPath (éventuellement en anglais) 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 d'ajout d'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
Sécurité des threads
Tout membre static (Shared dans Visual Basic) public de ce type garantit la sécurité des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.