IDataEnvironment.ConfigureConnection Metoda

Definicja

Przestrzeń nazw:

System.ComponentModel.Design.Data

Zestaw:

System.Design.dll

Zapisuje parametry połączenia w pliku konfiguracji aplikacji.

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

Parametry

owner

IWin32Window

Okno nadrzędne okna dialogowego, jeśli istnieje.

connection

DesignerDataConnection

DesignerDataConnection Obiekt zawierający dane połączenia do zapisania.

name

String

Nazwa nowego wpisu konfiguracji połączenia.

Zwraca

DesignerDataConnection

DesignerDataConnection Obiekt zawierający zapisane dane połączenia z właściwością ustawioną Name na name, a właściwość ustawiona IsConfigured na true.

Uwagi

Metoda ConfigureConnection zapisuje połączenie z plikiem konfiguracji aplikacji. Nazwa parametry połączenia i dostawcy są zapisywane w elemecie konfiguracji connectionStrings (ASP.NET Settings Schema) o nazwie zgodnie z parametrem name . Właściwość Name parametru connection jest ignorowana.

Implementacje ConfigureConnection metody powinny zgłaszać następujące wyjątki.

Wyjątek	Przyczyna
ArgumentException	W pliku konfiguracji aplikacji istnieje zduplikowana nazwa.
FileNotFoundException, UnauthorizedAccessExceptionlub inny odpowiedni wyjątek we/wy pliku.	Nie można zaktualizować pliku konfiguracji aplikacji. Implementacja ConfigureConnection metody powinna zgłosić odpowiedni wyjątek.
CheckoutException	Nie można wyewidencjonować pliku konfiguracji aplikacji z systemu kontroli źródła.

Rozważ użycie interfejsów API zarządzania konfiguracją w System.Configuration przestrzeni nazw, aby odczytywać i zapisywać plik konfiguracji aplikacji. Klasa ConnectionStringsSection odczytuje i zapisuje element konfiguracji connectionStrings (ASP.NET Settings Schema).