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( falls vorhanden). Um eine neue Verbindung zu erstellen, initialConnection sollte es sich um nulleine .
Gibt zurück
Ein neues oder bearbeitetes DesignerDataConnection Objekt oder null wenn der Benutzer abgesagt hat.
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 er 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 die Erstellung der Datenverbindung verantwortlich, fügt die Verbindung entweder einer globalen Liste von Verbindungen oder der Konfigurationsdatei der Webanwendung hinzu und fügt die neue Verbindung zur Connections Eigenschaft hinzu.
Die neue Verbindung sollte die Informationen enthalten, die die Anwendung zur Laufzeit zum Erstellen einer Datenverbindung 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 Neuen Verbindungserstellungsprozess abbrechen möchte, sollte die BuildConnection Methode zurückgegeben werden null.
