AdoQueryConnection.Command Eigenschaft

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Text der SQL-Befehlszeichenfolge für ein AdoQueryConnection -Objekt ab oder legt den Text fest.

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

Eigenschaftswert

String

Der SQL-Befehlstext der Datenverbindung.

Beispiele

Im folgenden Beispiel werden die Command-Eigenschaft der ADOQueryConnection-Klasse und die Execute() -Methode der DataConnection -Klasse verwendet, um eine Tabelle in einer sekundären Datenquelle mit dem Namen Employees abzufragen. Die Abfrage wird für die Datenverbindung ausgeführt, die im InfoPath-Entwurfsmodus in der Datenbank erstellt wurde, die die Employee-Tabelle (ebenfalls mit der Bezeichnung "Employee") enthält.

Zunächst wird der vom Benutzer in das Feld my:EmpID eingegebene Wert verwendet, um den SQL-Befehlstext mithilfe der Command-Eigenschaft zu aktualisieren. Anschließend wird die Execute-Methode verwendet, um die von der Datenverbindung abgerufenen Daten zu aktualisieren. Dadurch wird der Datensatz aktualisiert, der in einem Steuerelement für wiederholte Tabellen angezeigt wird, das an die Tabelle Employees im Formular gebunden ist. In diesem Beispiel muss das Feld my:EmpID in der Standard Datenquelle, die an ein Textfeld-Steuerelement in einer Ansicht gebunden ist, die ein Button-Steuerelement enthält, den folgenden Code aufrufen.

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

Hinweise

Die Command-Eigenschaft des ADOQueryConnection-Objekts enthält den SQL-Befehltext, der von der ADO-Datenverbindung (ActiveX Data Objects) verwendet wird, um Daten aus einer externen ADO-/OLEDB-Datenquelle abzurufen.

Hinweis: Das ADOQueryConnection-Objekt kann nur mit Microsoft SQL Server- und Microsoft Access-Datenbanken verwendet werden.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für:

Freigeben über