IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.DesignerDataConnectionPublic Function BuildConnection (owner As IWin32Window, initialConnection As DesignerDataConnection) As DesignerDataConnectionParâ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
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.
