IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea una nuova connessione dati o modifica una connessione esistente usando la nuova interfaccia utente di connessione dello strumento di progettazione.
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 DesignerDataConnectionParametri
- owner
- IWin32Window
Finestra padre per la finestra di dialogo di connessione.
- initialConnection
- DesignerDataConnection
Connessione, se presente, da modificare. Per creare una nuova connessione, initialConnection deve essere null.
Restituisce
Oggetto nuovo o modificato DesignerDataConnection oppure null se l'utente ha annullato.
Commenti
Utilizzare il BuildConnection metodo per attivare l'interfaccia utente dell'ambiente di progettazione per la creazione o la modifica di connessioni dati. Se il initialConnection parametro è null, indica che l'utente vuole creare una nuova connessione. Se il initialConnection parametro è un DesignerDataConnection oggetto , indica che l'utente vuole modificare una connessione esistente.
L'ambiente di progettazione è responsabile della creazione della connessione dati, dell'aggiunta della connessione a un elenco globale di connessioni o al file di configurazione dell'applicazione Web e dell'aggiunta della Connections nuova connessione alla proprietà .
La nuova connessione deve includere le informazioni necessarie all'applicazione per creare una connessione dati in fase di esecuzione. Se è necessario usare la connessione dati nell'ambiente di progettazione, usare il GetDesignTimeConnection metodo per restituire un DbConnection oggetto che si connetterà all'archivio dati dall'ambiente di progettazione.
Se l'utente sceglie di annullare il nuovo processo di creazione della connessione, il BuildConnection metodo deve restituire null.
