IDataEnvironment.BuildQuery Método

Referência

Definição

Namespace:: System.ComponentModel.Design.Data

Assembly:: System.Design.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

String

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

Compartilhar via