Partager via


IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Méthode

Définition

Crée une connexion de données ou modifie une connexion existante à l'aide de la nouvelle interface utilisateur de connexion de l'outil de conception.

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

Paramètres

owner
IWin32Window

Fenêtre parente de la boîte de dialogue de connexion.

initialConnection
DesignerDataConnection

Connexion à modifier, le cas échéant. Pour créer une connexion, initialConnection doit être null.

Retours

Objet DesignerDataConnection nouveau ou modifié, ou null si l'utilisateur a annulé l'opération.

Remarques

Utilisez la BuildConnection méthode pour activer l’interface utilisateur de l’environnement de conception pour créer ou modifier des connexions de données. Si le initialConnection paramètre est null, il indique que l’utilisateur souhaite créer une connexion. Si le initialConnection paramètre est un DesignerDataConnection objet, il indique que l’utilisateur souhaite modifier une connexion existante.

Votre environnement de conception est chargé de créer la connexion de données, d’ajouter la connexion à une liste globale de connexions ou au fichier de configuration de l’application web, et d’ajouter la nouvelle connexion à la Connections propriété .

La nouvelle connexion doit inclure les informations dont l’application a besoin pour créer une connexion de données au moment de l’exécution. Si vous devez utiliser la connexion de données dans l’environnement de conception, utilisez la GetDesignTimeConnection méthode pour retourner un DbConnection objet qui se connectera au magasin de données à partir de l’environnement de conception.

Si l’utilisateur choisit d’annuler le processus de création de nouvelle connexion, la BuildConnection méthode doit retourner null.

S’applique à