IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Metodo

Definizione

Spazio dei nomi:

System.ComponentModel.Design.Data

Assembly:

System.Design.dll

Crea una nuova connessione dati o modifica una connessione esistente mediante 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.DesignerDataConnection

Public Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnection

Parametri

owner

IWin32Window

Finestra padre per la finestra di connessione.

initialConnection

DesignerDataConnection

Eventuale connessione da modificare. Per creare una nuova connessione, il parametro initialConnection deve essere null.

Restituisce

DesignerDataConnection

Oggetto DesignerDataConnection nuovo o modificato 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 delle 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.