AdoSubmitConnection.Command Propriété

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.

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

public:
 abstract property System::String ^ Command { System::String ^ get(); void set(System::String ^ value); };

public abstract string Command { get; set; }

member this.Command : string with get, set

Public MustOverride Property Command As String

Valeur de propriété

String

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

Exemples

Dans l’exemple suivant, la propriété Command de la classe AdoSubmitConnection et la Execute() méthode de la DataConnection classe sont utilisées pour interroger une table dans une source de données secondaire nommée Employees. 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, ce qui met à jour l’enregistrement affiché dans un contrôle Table répétée lié à la table Employees sur le 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] = " &amp; employeeID

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

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 existe un objet ADOQueryConnection correspondant et que les connexions de données représentées par les deux objets partagent le même ensemble de valeurs de propriété. La modification de la valeur de cette propriété pour l’objet ADOSubmitConnection modifie également la valeur de la même propriété pour l’objet ADOQueryConnection correspondant.

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

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 uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

Partager via