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
'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 (Nothing 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 |
---|---|
Requête |
|
Envoi |
|
Requête |
|
Envoi |
|
Envoi |
|
Requête |
|
Envoi |
|
SharePointListRWQueryConnection
Remarque
La classe SharepointListQueryConnection utilisée dans les versions précédentes d'InfoPath est maintenant obsolète.
|
Requête |
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 valables pour plusieurs domaines.
Ce type ou ce membre est accessible à 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