IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Metoda

Definice

Obor názvů:

System.ComponentModel.Design.Data

Sestavení:

System.Design.dll

Vytvoří nové datové připojení nebo upraví existující připojení pomocí nového uživatelského rozhraní nástroje pro návrh.

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

Nadřazené okno dialogového okna připojení.

initialConnection

DesignerDataConnection

Připojení, pokud existuje, pro úpravy. Chcete-li vytvořit nové připojení, initialConnection musí být null.

Návraty

DesignerDataConnection

Nový nebo upravený DesignerDataConnection objekt nebo null pokud uživatel zrušil.

Poznámky

Tuto metodu BuildConnection použijte k aktivaci uživatelského rozhraní návrhového prostředí pro vytváření nebo úpravu datových připojení. initialConnection Pokud je nullparametr , znamená to, že uživatel chce vytvořit nové připojení. initialConnection Pokud je parametr objektemDesignerDataConnection, znamená to, že uživatel chce upravit existující připojení.

Vaše návrhové prostředí zodpovídá za vytvoření datového připojení, přidání připojení buď do globálního seznamu připojení, nebo do konfiguračního souboru webové aplikace a přidání nového připojení k Connections vlastnosti.

Nové připojení by mělo obsahovat informace, které aplikace potřebuje k vytvoření datového připojení za běhu. Pokud potřebujete použít datové připojení v návrhovém prostředí, použijte GetDesignTimeConnection metodu DbConnection k vrácení objektu, který se připojí k úložišti dat z návrhového prostředí.

Pokud se uživatel rozhodne zrušit nový proces vytváření připojení, BuildConnection metoda by měla vrátit null.