IDataEnvironment.BuildConnection(IWin32Window, DesignerDataConnection) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria uma nova ligação de dados ou edita uma ligação existente usando a nova interface de ligaçã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 principal para o diálogo de ligação.
- initialConnection
- DesignerDataConnection
A ligação, se houver, para editar. Para criar uma nova ligação, initialConnection deve ser null.
Devoluções
Um objeto novo ou editado DesignerDataConnection , ou null se o utilizador cancelou.
Observações
Use o BuildConnection método para ativar a interface de utilizador do ambiente de design para criar ou editar ligações de dados. Se o initialConnection parâmetro for null, indica que o utilizador quer criar uma nova ligação. Se o initialConnection parâmetro for um DesignerDataConnection objeto, indica que o utilizador quer editar uma ligação existente.
O seu ambiente de design é responsável por criar a ligação de dados, adicionando a ligação a uma lista global de ligações ou ao ficheiro de configuração da aplicação Web, e adicionando a nova ligação à Connections propriedade.
A nova ligação deve incluir a informação de que a aplicação precisa para criar uma ligação de dados em tempo de execução. Se precisares de usar a ligação de dados no ambiente de design, usa o GetDesignTimeConnection método para devolver um DbConnection objeto que se ligue ao armazenamento de dados a partir do ambiente de design.
Se o utilizador optar por cancelar o novo processo de criação de ligação, o BuildConnection método deverá devolver null.