IDataEnvironment.ConfigureConnection Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.DesignerDataConnectionPublic Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnectionParameter
- 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).
