IDataEnvironment.ConfigureConnection 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.
Escreve uma cadeia de ligação no ficheiro de configuração da aplicação.
public:
System::ComponentModel::Design::Data::DesignerDataConnection ^ ConfigureConnection(System::Windows::Forms::IWin32Window ^ owner, System::ComponentModel::Design::Data::DesignerDataConnection ^ connection, System::String ^ name);public System.ComponentModel.Design.Data.DesignerDataConnection ConfigureConnection(System.Windows.Forms.IWin32Window owner, System.ComponentModel.Design.Data.DesignerDataConnection connection, string name);abstract member ConfigureConnection : System.Windows.Forms.IWin32Window * System.ComponentModel.Design.Data.DesignerDataConnection * string -> System.ComponentModel.Design.Data.DesignerDataConnectionPublic Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnectionParâmetros
- owner
- IWin32Window
A janela principal para o diálogo, se existir.
- connection
- DesignerDataConnection
Um DesignerDataConnection objeto contendo os dados de ligação a guardar.
- name
- String
O nome da nova entrada de configuração de ligação.
Devoluções
Um DesignerDataConnection objeto contendo os dados de ligação guardados com a Name propriedade definida para name, e a IsConfigured propriedade definida para true.
Observações
O ConfigureConnection método escreve uma ligação ao ficheiro de configuração da aplicação. O cadeia de ligação e o nome do fornecedor são escritos no elemento de configuração connectionStrings (ASP.NET Settings Schema) nomeado de acordo com o parâmetro name. A Name propriedade do connection parâmetro é ignorada.
As implementações do ConfigureConnection método devem apresentar as seguintes exceções.
| Exception | Justificação |
|---|---|
| ArgumentException | Existe um nome duplicado no ficheiro de configuração da aplicação. |
| FileNotFoundException, UnauthorizedAccessException, ou outra exceção de IO de ficheiro apropriada. | O ficheiro de configuração da aplicação não pode ser atualizado. A implementação do teu ConfigureConnection método deve lançar uma exceção apropriada. |
| CheckoutException | O ficheiro de configuração da aplicação não pode ser extraído do sistema de controlo de versão. |
Considere usar as APIs de gestão de configuração no System.Configuration namespace para ler e escrever o ficheiro de configuração da aplicação. A classe ConnectionStringsSection irá ler e escrever o elemento de configuração connectionStrings (ASP.NET Settings Schema).
