DataConnection.Execute, méthode

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

Public MustOverride Sub Execute

Dim instance As DataConnection

instance.Execute

public abstract void Execute ()

Exceptions

Type d'exception	Condition
WebException	L'opération d'exécution a échoué.

Remarques

Lors de la conception d'un modèle de formulaire, vous pouvez utiliser la commande Options d'envoi de formulaire du menu Outils 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 du menu Outils 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.

AdoQueryConnection

Requête

AdoSubmitConnection

Envoi

EmailSubmitConnection

Envoi

FileQueryConnection

Requête

FileSubmitConnection

Envoi

SharepointListQueryConnection

Requête

WebServiceConnection

Envoi ou Requête

Ce membre est accessible uniquement par les formulaires qui s'exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d'autorisations indépendantes des domaines.

Ce type ou ce membre est accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007 ou un navigateur Web.

Exemple

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
Membres DataConnection
Microsoft.Office.InfoPath, espace de noms