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