Udostępnij za pośrednictwem


IDataEnvironment.ConfigureConnection Metoda

Definicja

Zapisuje parametry połączenia do 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 Obiekt zawierający zapisane dane połączenia z właściwością ustawioną Name na name, a właściwość ustawioną IsConfigured na true.

Uwagi

Metoda ConfigureConnection zapisuje połączenie z plikiem konfiguracji aplikacji. Parametry połączenia i nazwa dostawcy są zapisywane w elemecie konfiguracji connectionStrings Element (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).

Dotyczy