IDataEnvironment.BuildQuery Méthode

Définition

Espace de noms:

System.ComponentModel.Design.Data

Assembly:

System.Design.dll

Lance une boîte de dialogue pour générer une chaîne de requête SQL.

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

Paramètres

owner

IWin32Window

Fenêtre parente de la boîte de dialogue.

connection

DesignerDataConnection

Connexion de données à utiliser pour la requête.

mode

QueryBuilderMode

Une des valeurs de l'objet QueryBuilderMode.

initialQueryText

String

Valeur initiale de la requête ou Empty pour créer une requête.

Retours

String

Chaîne contenant la requête SQL, ou null si l'utilisateur a annulé l'opération.

Remarques

La BuildQuery méthode lance l’interface utilisateur de l’environnement de conception pour la modification ou la création de chaînes de requête SQL. Si le initialQueryText paramètre est Empty, cela indique que l’utilisateur souhaite créer une requête. Si le initialQueryText paramètre contient une chaîne, cela indique que l’utilisateur souhaite modifier la requête existante.

Le mode paramètre indique le type de requête que l’utilisateur souhaite générer ; sélectionner, mettre à jour, insérer ou supprimer. Votre interface utilisateur peut utiliser le mode paramètre pour se configurer pour le type de requête souhaité, limiter l’utilisateur à l’utilisation d’instructions SQL valides uniquement pour le type de requête souhaité et/ou valider la requête par rapport au type souhaité.