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

Die SQL-Befehlszeichenfolge für die Datenverbindung.

Beispiele

Im folgenden Beispiel werden die Command-Eigenschaft der AdoSubmitConnection-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 für die Datenbank erstellt wurde, die die Employees-Tabelle enthält und "EmployeesSubmit" heißt.

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

Hinweise

Die Command-Eigenschaft des ADOSubmitConnection-Objekts enthält den SQL-Befehlstext, der von der ADO-Datenverbindung verwendet wird, um Daten an eine externe ActiveX Data Objects/OLEDB-Datenquelle zu senden.

Wichtig: Ein ADOSubmitConnection-Objekt kann nur vorhanden sein, wenn ein entsprechendes ADOQueryConnection-Objekt vorhanden ist und die datenverbindungen, die von beiden Objekten dargestellt werden, denselben Satz von Eigenschaftswerten verwenden. Wenn der Wert dieser Eigenschaft für das ADOSubmitConnection-Objekt geändert wird, wird auch der Wert dieser Eigenschaft für das entsprechende ADOQueryConnection-Objekt geändert.

Hinweis: Das ADOSubmitConnection-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 nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Freigeben über