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 DesignerDataConnection objeto que contém os dados de conexão a serem salvos.
- name
- String
O nome da nova entrada de configuração de conexão.
Retornos
Um DesignerDataConnection objeto que contém os dados de conexão salvos com a Name propriedade definida como name, e a IsConfigured propriedade 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 | Reason |
|---|---|
| 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 | O arquivo de configuração do aplicativo não pode ser verificado 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 connectionStrings Element (ASP.NET Settings Schema).
