IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt u een nieuwe gegevensverbinding of bewerkt u een bestaande verbinding met behulp van de nieuwe gebruikersinterface van het ontwerpprogramma.
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 DesignerDataConnectionParameters
- owner
- IWin32Window
Het bovenliggende venster voor het verbindingsdialoogvenster.
- initialConnection
- DesignerDataConnection
De verbinding, indien aanwezig, om te bewerken. Als u een nieuwe verbinding wilt maken, initialConnection moet dit zijn null.
Retouren
Een nieuw of bewerkt DesignerDataConnection object, of null als de gebruiker heeft geannuleerd.
Opmerkingen
Gebruik de BuildConnection methode om de gebruikersinterface van de ontwerpomgeving te activeren voor het maken of bewerken van gegevensverbindingen. Als de initialConnection parameter is null, geeft dit aan dat de gebruiker een nieuwe verbinding wil maken. Als de initialConnection parameter een DesignerDataConnection object is, geeft dit aan dat de gebruiker een bestaande verbinding wil bewerken.
Uw ontwerpomgeving is verantwoordelijk voor het maken van de gegevensverbinding, het toevoegen van de verbinding met een globale lijst met verbindingen of het configuratiebestand van de webtoepassing en het toevoegen van de nieuwe verbinding met de Connections eigenschap.
De nieuwe verbinding moet de informatie bevatten die de toepassing nodig heeft om tijdens runtime een gegevensverbinding te maken. Als u de gegevensverbinding in de ontwerpomgeving wilt gebruiken, gebruikt u de GetDesignTimeConnection methode om een DbConnection object te retourneren dat verbinding maakt met het gegevensarchief vanuit de ontwerpomgeving.
Als de gebruiker ervoor kiest om het nieuwe proces voor het maken van de verbinding te annuleren, moet de BuildConnection methode worden geretourneerd null.
