Teilen über


IDataEnvironment.BuildQuery Methode

Definition

Startet ein Dialogfeld, um eine SQL-Abfragezeichenfolge zu erstellen.

public:
 System::String ^ BuildQuery(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ connection, System::ComponentModel::Design::Data::QueryBuilderMode mode, System::String ^ initialQueryText);
public string BuildQuery (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection connection, System.ComponentModel.Design.Data.QueryBuilderMode mode, string initialQueryText);
abstract member BuildQuery : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection * System.ComponentModel.Design.Data.QueryBuilderMode * string -> string
Public Function BuildQuery (owner As IWin32Window, connection As DesignerDataConnection, mode As QueryBuilderMode, initialQueryText As String) As String

Parameter

owner
IWin32Window

Das übergeordnete Fenster für das Dialogfeld.

connection
DesignerDataConnection

Die für die Abfrage zu verwendende Datenverbindung.

mode
QueryBuilderMode

Einer der QueryBuilderMode-Werte.

initialQueryText
String

Der Anfangswert der Abfrage oder Empty, um eine neue Abfrage zu erstellen.

Gibt zurück

Eine Zeichenfolge mit der SQL-Abfrage oder null, wenn ein Abbruch durch den Benutzer erfolgt ist.

Hinweise

Die BuildQuery -Methode startet die Benutzeroberfläche der Entwurfsumgebung zum Bearbeiten oder Erstellen von SQL-Abfragezeichenfolgen. Wenn der initialQueryText Parameter ist Empty, gibt dies an, dass der Benutzer eine neue Abfrage erstellen möchte. Wenn der initialQueryText Parameter eine Zeichenfolge enthält, gibt er an, dass der Benutzer die vorhandene Abfrage bearbeiten möchte.

Der mode Parameter gibt den Typ der Abfrage an, die der Benutzer erstellen möchte. Entweder auswählen, aktualisieren, einfügen oder löschen. Ihre Benutzeroberfläche kann den mode Parameter verwenden, um sich selbst für den gewünschten Abfragetyp zu konfigurieren, den Benutzer auf die Verwendung von SQL-Anweisungen beschränken, die nur für den gewünschten Abfragetyp gültig sind, und/oder die Abfrage anhand des gewünschten Typs überprüfen.

Gilt für: