DataConnection.Execute Méthode

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.

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.

public:
 abstract void Execute();

public abstract void Execute ();

abstract member Execute : unit -> unit

Public MustOverride Sub Execute ()

Exceptions

WebException

L'opération d'exécution a échoué.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en 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 Execute() méthode 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.

Exemples

Dans l’exemple suivant, une fois que la propriété Command de la classe ADOQueryConnection est utilisée pour mettre à jour le texte de la commande SQL de la connexion de données, la méthode Execute de la DataConnection classe est utilisée pour exécuter la requête afin d’actualiser les données dans le 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

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’utilisation de la Execute() méthode effectue une opération d’envoi ou de requête sur la connexion de données à l’aide de ces paramètres définis de manière 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	Envoyer
BdcQueryConnection	Requête
BdcSubmitConnection	Envoyer
EmailSubmitConnection	Envoyer
FileQueryConnection	Requête
FileSubmitConnection	Envoyer
SharePointListRWQueryConnectionRemarqueLa SharepointListQueryConnection classe utilisée dans les versions précédentes d’InfoPath a été dépréciée.	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.

S’applique à

Partager via