IDataEnvironment.ConfigureConnection Método

Definição

Namespace:

System.ComponentModel.Design.Data

Assembly:

System.Design.dll

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

DesignerDataConnection

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