Freigeben über


IDataEnvironment.ConfigureConnection Methode

Definition

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

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 mit der Konfigurationsdatei der Anwendung. Die Verbindungszeichenfolge und der Anbietername werden in das Konfigurationselement connectionStrings-Element (ASP.NET-Einstellungsschema) geschrieben, das gemäß dem name Parameter benannt ist. 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 Konfigurationsverwaltungs-APIs im System.Configuration Namespace zu verwenden, um die Konfigurationsdatei der Anwendung zu lesen und zu schreiben. Die ConnectionStringsSection -Klasse liest und schreibt das Konfigurationselement connectionStrings-Element (ASP.NET-Einstellungsschema).

Gilt für: