Partilhar via


IDataEnvironment.BuildQuery Método

Definição

Inicializa uma caixa de diálogo para criar uma cadeia de caracteres de consulta 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

Parâmetros

owner
IWin32Window

A janela pai da caixa de diálogo.

connection
DesignerDataConnection

A conexão de dados a ser usada para a consulta.

mode
QueryBuilderMode

Um dos valores de QueryBuilderMode.

initialQueryText
String

O valor inicial da consulta ou Empty para criar uma nova consulta.

Retornos

Uma cadeia de caracteres que contém a consulta SQL ou null, se o usuário tiver cancelado.

Comentários

O BuildQuery método inicia a interface do usuário do ambiente de design para editar ou criar cadeias de caracteres de consulta SQL. Se o initialQueryText parâmetro for Empty, ele indicará que o usuário deseja criar uma nova consulta. Se o initialQueryText parâmetro contiver uma cadeia de caracteres, ele indicará que o usuário deseja editar a consulta existente.

O mode parâmetro indica o tipo de consulta que o usuário deseja criar; selecione, atualize, insira ou exclua. Sua interface do usuário pode usar o mode parâmetro para se configurar para o tipo de consulta desejado, limitar o usuário a usar instruções SQL válidas somente para o tipo de consulta desejado e/ou validar a consulta no tipo desejado.

Aplica-se a