IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una nueva conexión de datos o edita una conexión existente utilizando la interfaz de usuario de nueva conexión de la herramienta de diseño.
public:
System::ComponentModel::Design::Data::DesignerDataConnection ^ BuildConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ initialConnection);public System.ComponentModel.Design.Data.DesignerDataConnection BuildConnection (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection initialConnection);abstract member BuildConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection -> System.ComponentModel.Design.Data.DesignerDataConnectionPublic Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnectionParámetros
- owner
- IWin32Window
Ventana primaria para el cuadro de diálogo de conexión.
- initialConnection
- DesignerDataConnection
Conexión que, en su caso, se va a editar. Para crear una nueva conexión, initialConnection debe ser null.
Devoluciones
Objeto DesignerDataConnection nuevo o editado, o null si el usuario cancela.
Comentarios
Use el BuildConnection método para activar la interfaz de usuario del entorno de diseño para crear o editar conexiones de datos. Si el initialConnection parámetro es null, indica que el usuario quiere crear una nueva conexión. Si el initialConnection parámetro es un DesignerDataConnection objeto , indica que el usuario quiere editar una conexión existente.
El entorno de diseño es responsable de crear la conexión de datos, agregar la conexión a una lista global de conexiones o al archivo de configuración de la aplicación web y agregar la nueva conexión a la Connections propiedad .
La nueva conexión debe incluir la información que la aplicación necesita para crear una conexión de datos en tiempo de ejecución. Si necesita usar la conexión de datos en el entorno de diseño, use el GetDesignTimeConnection método para devolver un DbConnection objeto que se conectará al almacén de datos desde el entorno de diseño.
Si el usuario decide cancelar el nuevo proceso de creación de la conexión, el BuildConnection método debe devolver null.
