DataConnection.Execute - Méthode

Article
05/11/2015

Selon la classe TypeConnexionConnection à partir de laquelle elle est appelée, exécute une opération de requête ou d'envoi sur la connexion de données en utilisant les valeurs définies de façon déclarative pour les données envoyées, les paramètres de la requête ou les données à récupérer.

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

Syntaxe

'Déclaration
Public MustOverride Sub Execute
'Utilisation
Dim instance As DataConnection

instance.Execute()

public abstract void Execute()

Exceptions

Exception	Condition
WebException	L'opération d'exécution a échoué.
ArgumentNullException	Les paramètres transmis à cette méthode sont une référence Null (Rien dans Visual Basic).
ArgumentException	Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.
InvalidOperationException	Pour les opérations d'envoi, la méthode Execute() a été appelée à partir d'un gestionnaire d'événements pour l'événement Loading.
SEHException	Une erreur du gestionnaire d'exceptions structurées (SEH, Structured Exception Handler) a été levée à partir d'un code non managé qui n'est pas mappé à une exception de code managé équivalent. Pour plus d'informations, effectuez une recherche sur « exceptions non managées » et « Gestion des exceptions structurées » dans MSDN Library.

Remarques

Lors de la conception d'un modèle de formulaire, vous pouvez utiliser la commande Actions d'envoi sous l'onglet Données pour définir la destination d'envoi ainsi que des options connexes, stockées dans le fichier de définition de solution (.xsf) du fichier de modèle de formulaire. Vous pouvez également avoir recours à la commande Connexions de données sous l'onglet Données pour définir les paramètres d'envoi ou de réception de données, également stockés dans le fichier de définition de solution (.xsf). L'appel de la méthode Execute() exécute une opération d'envoi ou de requête sur la connexion de données en utilisant ces paramètres définis de façon déclarative.

La méthode DataConnection.Execute est héritée par toutes les classes représentant des connexions de données et elle est exposée en tant que méthode héritée de cette classe, par exemple la méthode EmailSubmitConnection.Execute(). Selon le type de connexion de données que représente la classe qui en hérite, la méthode Execute exécute l'opération de requête ou d'envoi déclarée, adaptée à cette connexion.

Classe	Operation
AdoQueryConnection	Requête
AdoSubmitConnection	Envoi
BdcQueryConnection	Requête
BdcSubmitConnection	Envoi
EmailSubmitConnection	Envoi
FileQueryConnection	Requête
FileSubmitConnection	Envoi
SharePointListRWQueryConnection Notes La classe SharepointListQueryConnection utilisée dans les versions précédentes d'InfoPath est maintenant obsolète.	Requête
WebServiceConnection	Envoi ou Requête

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

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

Exemples

Dans l'exemple suivant, après avoir utilisé la propriété Command de la classe ADOQueryConnection pour mettre à jour le texte de la commande SQL de la connexion de données, la méthode Execute de la classe DataConnection est appelée pour exécuter la requête visant à actualiser les données du formulaire.

public void RefreshData_Clicked(object sender, ClickedEventArgs e)
{
   // Get the Employees connection from the 
   // DataConnections collection.
   AdoQueryConnection myAdoQueryConnection =
      (AdoQueryConnection)(this.DataConnections["Employees"]);

   // Get the employee's ID from the EmpID field in 
   // the main data source.
   XPathNavigator myNav = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", 
      NamespaceManager);
   // Assign the value from the field to a variable.
   string employeeID = myNav.InnerXml;

   // Change the SQL command for Employees connection to retrieve 
   // the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = 
      "select * from [Employees] where [EmployeeID] = " + employeeID;

   // Execute the updated command against the data connection to 
   // refresh the data.
   myAdoQueryConnection.Execute();
}

Public Sub RefreshData_Clicked(ByVal sender As Object, ByVal e As ClickedEventArgs)
   ' Get the Employees connection from the 
   ' DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

   ' Get the employee's ID from the EmpID field in 
   ' the main data source.
   Dim myNav As XPathNavigator = _
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", _
      NamespaceManager)
   Dim employeeID As String = myNav.InnerXml

   ' Change the SQL command for Employees connection to retrieve 
   ' the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = _
      "select * from [Employees] where [EmployeeID] = " + employeeID

   ' Execute the updated command against the data connection to 
   ' refresh the data.
    myAdoQueryConnection.Execute()
End Sub

Voir aussi

Référence

DataConnection classe

DataConnection - Membres

Microsoft.Office.InfoPath - Espace de noms

Partager via