IDataEnvironment.ConfigureConnection Méthode

Définition

Espace de noms:

System.ComponentModel.Design.Data

Assembly:

System.Design.dll

É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.DesignerDataConnection

Public Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnection

Paramè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

DesignerDataConnection

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).