AdoSubmitConnection.Command, propriété

Article
04/27/2010

Obtient ou définit le texte de chaîne de la commande SQL pour un objet AdoSubmitConnection.

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

Syntaxe

Public MustOverride Property Command As String

Dim instance As AdoSubmitConnection
Dim value As String

value = instance.Command

instance.Command = value

public abstract string Command { get; set; }

Valeur de la propriété

Chaîne de commande SQL pour la connexion de données.

Remarques

La propriété Command de l'objet ADOSubmitConnection contient le texte de commande SQL utilisé par la connexion de données ADO pour envoyer des données à une source de données externe ADO (ActiveX Data Objects)/OLEDB.

Important :
Un objet ADOSubmitConnection ne peut exister que s'il y a un objet ADOQueryConnection correspondant. Les connexions de données représentées par ces deux objets partagent aussi le même ensemble de valeurs de propriété. La modification de la valeur de cette propriété pour l'objet ADOSubmitConnection entraîne également celle de la valeur de la même propriété pour l'objet ADOQueryConnection correspondant.

Un objet ADOSubmitConnection ne peut exister que s'il y a un objet ADOQueryConnection correspondant. Les connexions de données représentées par ces deux objets partagent aussi le même ensemble de valeurs de propriété. La modification de la valeur de cette propriété pour l'objet ADOSubmitConnection entraîne également celle de la valeur de la même propriété pour l'objet ADOQueryConnection correspondant.

Remarque
L'objet ADOSubmitConnection est limité pour fonctionner uniquement avec des bases de données Microsoft SQL Server et Microsoft Access.

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 uniquement accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007.

Exemple

Dans l'exemple ci-dessous, la propriété Command de la classe AdoSubmitConnection et la méthode Execute de la classe DataConnection servent à interroger une table dans la source de données secondaire Employés. La requête est exécutée sur la connexion de données créée en mode Création dans InfoPath vers la base de données contenant la table Employés (EmployeesSubmit).

Tout d'abord, la valeur entrée par l'utilisateur dans le champ my:EmpID sert à mettre à jour le texte de la commande SQL à l'aide de la propriété Command. Ensuite, la méthode Execute est utilisée pour actualiser les données récupérées par la connexion de données, qui met à jour l'enregistrement affiché dans un contrôle Tableau extensible lié à la table Employés du formulaire. Cet exemple requiert le champ my:EmpID dans la source de données principale liée à un contrôle Zone de texte d'une vue contenant un contrôle Button permettant d'invoquer le code ci-dessous.

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

   // 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.
   myAdoSubmitConnection.Command = 
      "select * from [Employees] where [EmployeeID] = " + employeeID;

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

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

   ' 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.
    myAdoSubmitConnection.Execute()
End Sub

Voir aussi

Référence

AdoSubmitConnection, classe
Membres AdoSubmitConnection
Microsoft.Office.InfoPath, espace de noms

Partager via