IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Metoda

Definicja

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

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 jest, do edycji. Aby utworzyć nowe połączenie, initialConnection należy utworzyć . null

Zwraca

DesignerDataConnection

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

Uwagi

Użyj metody , aby aktywować interfejs użytkownika środowiska projektowego do BuildConnection tworzenia lub edytowania połączeń danych. Jeśli parametr initialConnection ma wartość , oznacza null to, że użytkownik chce utworzyć nowe połączenie. Jeśli parametr initialConnection jest DesignerDataConnection obiektem, oznacza to, ż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 do Connections właściwości .

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

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

Dotyczy