IDataEnvironment.BuildQuery Método

Definición

Espacio de nombres:

System.ComponentModel.Design.Data

Ensamblado:

System.Design.dll

Inicia un cuadro de diálogo para crear una cadena 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

Ventana primaria para el cuadro de diálogo.

connection

DesignerDataConnection

Conexión de datos que se va a utilizar para la consulta.

mode

QueryBuilderMode

Uno de los valores de QueryBuilderMode.

initialQueryText

String

Valor inicial de la consulta o Empty para crear una nueva consulta.

Devoluciones

String

Cadena que contiene la consulta SQL o null si el usuario cancela.

Comentarios

El BuildQuery método inicia la interfaz de usuario del entorno de diseño para editar o crear cadenas de consulta SQL. Si el initialQueryText parámetro es Empty, indica que el usuario quiere crear una nueva consulta. Si el initialQueryText parámetro contiene una cadena, indica que el usuario quiere editar la consulta existente.

El mode parámetro indica el tipo de consulta que el usuario quiere compilar; seleccione, actualice, inserte o elimine. La interfaz de usuario puede usar el mode parámetro para configurarse para el tipo de consulta deseado, limitar al usuario a usar instrucciones SQL válidas solo para el tipo de consulta deseado y/o validar la consulta con el tipo deseado.