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 mediante la nueva interfaz de usuario de 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 del cuadro de diálogo de conexión.
- initialConnection
- DesignerDataConnection
Conexión, si existe, que se va a editar. Para crear una conexión, initialConnection debe ser null.
Devoluciones
Un objeto nuevo o editado DesignerDataConnection , o null si el usuario canceló.
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 conexiones, el BuildConnection método debe devolver null.
