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í pro připojení 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, které chcete upravit. Pokud chcete 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 předplatné.

Poznámky

BuildConnection Pomocí metody aktivujte uživatelské rozhraní návrhového prostředí pro vytváření nebo úpravy 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í do globálního seznamu připojení nebo do konfiguračního souboru webové aplikace a přidání nového připojení do 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 metodu GetDesignTimeConnection k vrácení objektu DbConnection , který se připojí k úložišti dat z návrhového prostředí.

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