Partilhar via


IDataEnvironment.ConfigureConnection Método

Definição

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.DesignerDataConnection
Public Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnection

Parâ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).

Aplica-se a