IDataEnvironment.ConfigureConnection Methode

Definition

Namespace:

System.ComponentModel.Design.Data

Assembly:

System.Design.dll

Schreibt eine Verbindungszeichenfolge in die Konfigurationsdatei der Anwendung.

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

Parameter

owner

IWin32Window

Das übergeordnete Fenster für das Dialogfeld, sofern vorhanden.

connection

DesignerDataConnection

Ein DesignerDataConnection-Objekt, das die zu speichernden Verbindungsdaten enthält.

name

String

Der Name des Konfigurationseintrags für die neue Verbindung.

Gibt zurück

DesignerDataConnection

Ein DesignerDataConnection-Objekt, das die gespeicherten Verbindungsdaten mit der auf name festgelegten Name-Eigenschaft und der auf true festgelegten IsConfigured-Eigenschaft enthält.

Hinweise

Die ConfigureConnection -Methode schreibt eine Verbindung in die Konfigurationsdatei der Anwendung. Die Verbindungszeichenfolge und der Anbietername werden gemäß name dem Parameter in das Konfigurationselement connectionStrings-Element (ASP.NET Settings Schema) geschrieben. Die Name -Eigenschaft des connection Parameters wird ignoriert.

Implementierungen der ConfigureConnection -Methode sollten die folgenden Ausnahmen auslösen.

Ausnahme	`Reason`
ArgumentException	In der Konfigurationsdatei der Anwendung ist ein doppelter Name vorhanden.
FileNotFoundException, UnauthorizedAccessExceptionoder eine andere geeignete Datei-E/A-Ausnahme.	Die Konfigurationsdatei der Anwendung kann nicht aktualisiert werden. Ihre ConfigureConnection Methodenimplementierung sollte eine entsprechende Ausnahme auslösen.
CheckoutException	Die Konfigurationsdatei der Anwendung kann nicht aus dem Quellcodeverwaltungssystem ausgecheckt werden.

Erwägen Sie die Verwendung der Konfigurationsverwaltungs-APIs im System.Configuration Namespace, um die Konfigurationsdatei der Anwendung zu lesen und zu schreiben. Die ConnectionStringsSection -Klasse liest und schreibt das Konfigurationselement connectionStrings-Element (ASP.NET Settings Schema).