IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.DesignerDataConnectionPublic Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnectionParamè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.
