IDataEnvironment.BuildQuery Methode

Definition

Startet ein Dialogfeld zum Erstellen einer SQL-Abfragezeichenfolge.

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 das Erstellen einer neuen Abfrage.

Gibt zurück

Eine Zeichenfolge, die die SQL-Abfrage enthält oder null der Benutzer abgebrochen hat.

Hinweise

Die BuildQuery Methode startet die Benutzeroberfläche der Entwurfsumgebung zum Bearbeiten oder Erstellen von SQL-Abfragezeichenfolgen. Wenn der initialQueryText Parameter lautet Empty, gibt er 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. Die Benutzeroberfläche kann den mode Parameter verwenden, um sich für den gewünschten Abfragetyp zu konfigurieren, den Benutzer auf die Verwendung von SQL-Anweisungen zu 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: