IDataEnvironment.ConfigureConnection 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.
Écrit une chaîne de connexion dans le fichier de configuration de l'application.
public:
System::ComponentModel::Design::Data::DesignerDataConnection ^ ConfigureConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ connection, System::String ^ name);public System.ComponentModel.Design.Data.DesignerDataConnection ConfigureConnection (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection connection, string name);abstract member ConfigureConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection * string -> System.ComponentModel.Design.Data.DesignerDataConnectionPublic Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnectionParamètres
- owner
- IWin32Window
Fenêtre parente de la boîte de dialogue, le cas échéant.
- connection
- DesignerDataConnection
Objet DesignerDataConnection contenant les données de connexion à enregistrer.
- name
- String
Nom de la nouvelle entrée de configuration de la connexion.
Retours
Objet DesignerDataConnection contenant les données de connexion enregistrées, la propriété Name ayant la valeur name et la propriété IsConfigured la valeur true.
Remarques
La ConfigureConnection méthode écrit une connexion au fichier de configuration de l’application. La chaîne de connexion et le nom du fournisseur sont écrits dans l’élément de configuration connectionStrings Element (ASP.NET Settings Schema) nommé en fonction du name paramètre. La Name propriété du connection paramètre est ignorée.
Les implémentations de la ConfigureConnection méthode doivent lever les exceptions suivantes.
| Exception | Motif |
|---|---|
| ArgumentException | Un nom en double existe dans le fichier de configuration de l’application. |
| FileNotFoundException, UnauthorizedAccessExceptionou toute autre exception d’E/S de fichier appropriée. | Impossible de mettre à jour le fichier de configuration de l’application. L’implémentation de votre ConfigureConnection méthode doit lever une exception appropriée. |
| CheckoutException | Le fichier de configuration de l’application ne peut pas être extrait du système de contrôle de code source. |
Envisagez d’utiliser les API de gestion de la configuration dans l’espace System.Configuration de noms pour lire et écrire le fichier de configuration de l’application. La ConnectionStringsSection classe lit et écrit l’élément de configuration connectionStrings Element (ASP.NET Settings Schema).
