IDataEnvironment.ConfigureConnection 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.
Grava uma cadeia de conexão no arquivo de configuração do aplicativo.
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 pai da caixa de diálogo, se houver.
- connection
- DesignerDataConnection
Um objeto DesignerDataConnection que contém os dados de conexão a salvar.
- name
- String
O nome da nova entrada de configuração de conexão.
Retornos
Um objeto DesignerDataConnection que contém os dados de conexão salvos com a propriedade Name definida como name e a propriedade IsConfigured definida como true.
Comentários
O ConfigureConnection método grava uma conexão com o arquivo de configuração do aplicativo. A cadeia de conexão e o nome do provedor são gravados no elemento de configuração connectionStrings Element (ASP.NET Settings Schema) nomeado de acordo com o name parâmetro . A Name propriedade do connection parâmetro é ignorada.
As implementações do ConfigureConnection método devem gerar as seguintes exceções.
| Exceção | Motivo |
|---|---|
| ArgumentException | Existe um nome duplicado no arquivo de configuração do aplicativo. |
| FileNotFoundException, UnauthorizedAccessExceptionou outra exceção de E/S de arquivo apropriada. | O arquivo de configuração do aplicativo não pode ser atualizado. A ConfigureConnection implementação do método deve gerar uma exceção apropriada. |
| CheckoutException | Não é possível fazer check-out do arquivo de configuração do aplicativo no sistema de controle do código-fonte. |
Considere usar as APIs de gerenciamento de configuração no System.Configuration namespace para ler e gravar o arquivo de configuração do aplicativo. A ConnectionStringsSection classe lerá e gravará o elemento de configuração connectionStrings Element (ASP.NET Settings Schema).
