Freigeben über


IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Methode

Definition

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.DesignerDataConnection
Public Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnection

Parameter

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.

Gilt für: