IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) 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.
Erstellt eine neue Datenverbindung oder bearbeitet eine vorhandene Verbindung mithilfe der neuen Verbindungsbenutzeroberfläche des Entwurfstools.
public:
System::ComponentModel::Design::Data::DesignerDataConnection ^ BuildConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ initialConnection);public System.ComponentModel.Design.Data.DesignerDataConnection BuildConnection (System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection initialConnection);abstract member BuildConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection -> System.ComponentModel.Design.Data.DesignerDataConnectionPublic Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnectionParameter
- owner
- IWin32Window
Das übergeordnete Fenster für das Verbindungsdialogfeld.
- initialConnection
- DesignerDataConnection
Die zu bearbeitende Verbindung, sofern vorhanden. Wenn Sie eine neue Verbindung erstellen möchten, muss initialConnection gleich null sein.
Gibt zurück
Ein neues oder bearbeitetes DesignerDataConnection-Objekt oder null, wenn ein Abbruch durch den Benutzer erfolgt ist.
Hinweise
Verwenden Sie die BuildConnection -Methode, um die Benutzeroberfläche der Entwurfsumgebung zum Erstellen oder Bearbeiten von Datenverbindungen zu aktivieren. Wenn der initialConnection Parameter lautet null, gibt dies an, dass der Benutzer eine neue Verbindung erstellen möchte. Wenn der initialConnection Parameter ein DesignerDataConnection -Objekt ist, gibt er an, dass der Benutzer eine vorhandene Verbindung bearbeiten möchte.
Ihre Entwurfsumgebung ist für das Erstellen der Datenverbindung, das Hinzufügen der Verbindung zu einer globalen Liste von Verbindungen oder zur Konfigurationsdatei der Webanwendung und das Hinzufügen der neuen Verbindung zur Connections -Eigenschaft verantwortlich.
Die neue Verbindung sollte die Informationen enthalten, die die Anwendung zum Erstellen einer Datenverbindung zur Laufzeit benötigt. Wenn Sie die Datenverbindung in der Entwurfsumgebung verwenden müssen, verwenden Sie die GetDesignTimeConnection -Methode, um ein DbConnection Objekt zurückzugeben, das eine Verbindung mit dem Datenspeicher aus der Entwurfsumgebung herstellt.
Wenn der Benutzer den Prozess zum Erstellen neuer Verbindungen abbricht, sollte die BuildConnection -Methode zurückgeben null.
