IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Método

  • Referência

Definição

Namespace:
System.ComponentModel.Design.Data
Assembly:
System.Design.dll

Cria uma nova conexão de dados ou edita uma conexão existente usando a nova interface do usuário de conexão da ferramenta de design.

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

Parâmetros

owner
IWin32Window

A janela pai para a caixa de diálogo de conexão.

initialConnection
DesignerDataConnection

A conexão, se houver, a editar. Para criar uma nova conexão, initialConnection deve ser null.

Retornos

DesignerDataConnection

Um objeto DesignerDataConnection novo ou editado ou null, se o usuário tiver cancelado.

Comentários

Use o BuildConnection método para ativar a interface do usuário do ambiente de design para criar ou editar conexões de dados. Se o initialConnection parâmetro for null, ele indicará que o usuário deseja criar uma nova conexão. Se o initialConnection parâmetro for um DesignerDataConnection objeto , ele indicará que o usuário deseja editar uma conexão existente.

Seu ambiente de design é responsável por criar a conexão de dados, adicionar a conexão a uma lista global de conexões ou ao arquivo de configuração do aplicativo Web e adicionar a nova conexão à Connections propriedade.

A nova conexão deve incluir as informações de que o aplicativo precisa para criar uma conexão de dados em tempo de execução. Se você precisar usar a conexão de dados no ambiente de design, use o GetDesignTimeConnection método para retornar um DbConnection objeto que se conectará ao armazenamento de dados do ambiente de design.

Se o usuário optar por cancelar o novo processo de criação de conexão, o BuildConnection método deverá retornar null.

Aplica-se a