AdoQueryConnection.Command Propriété

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Obtient ou définit le texte de la chaîne de commande SQL pour un AdoQueryConnection 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

Texte de commande SQL de la connexion de données.

Exemples

Dans l’exemple suivant, la propriété Command de la classe ADOQueryConnection 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 à la base de données qui contient la table Employee, également appelée « Employees ».

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.
   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

La propriété Command de l'objet ADOQueryConnection contient le texte de commande SQL, utilisé par la connexion de données ADO pour extraire des données d'une source de données externe ADO/OLEDB.

Remarque : L’objet ADOQueryConnection 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 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.