IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Metoda

Definicja

Przestrzeń nazw:

System.ComponentModel.Design.Data

Zestaw:

System.Design.dll

Tworzy nowe połączenie danych lub edytuje istniejące połączenie przy użyciu nowego interfejsu użytkownika połączenia narzędzia projektowego.

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

Parametry

owner

IWin32Window

Okno nadrzędne okna dialogowego połączenia.

initialConnection

DesignerDataConnection

Połączenie, jeśli istnieje, do edycji. Aby utworzyć nowe połączenie, initialConnection powinno to być null.

Zwraca

DesignerDataConnection

Nowy lub edytowany DesignerDataConnection obiekt lub null jeśli użytkownik anulował.

Uwagi

BuildConnection Użyj metody , aby aktywować interfejs użytkownika środowiska projektowego do tworzenia lub edytowania połączeń danych. initialConnection Jeśli parametr to null, wskazuje, że użytkownik chce utworzyć nowe połączenie. initialConnection Jeśli parametr jest obiektemDesignerDataConnection, wskazuje, że użytkownik chce edytować istniejące połączenie.

Środowisko projektowe jest odpowiedzialne za utworzenie połączenia danych, dodanie połączenia do globalnej listy połączeń lub pliku konfiguracji aplikacji internetowej oraz dodanie nowego połączenia z właściwością Connections .

Nowe połączenie powinno zawierać informacje wymagane przez aplikację do utworzenia połączenia danych w czasie wykonywania. Jeśli musisz użyć połączenia danych w środowisku projektowym, użyj GetDesignTimeConnection metody , aby zwrócić DbConnection obiekt, który połączy się z magazynem danych ze środowiska projektowego.

Jeśli użytkownik zdecyduje się anulować nowy proces tworzenia połączenia, BuildConnection metoda powinna zwrócić nullwartość .