IDataEnvironment.ConfigureConnection Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.ComponentModel.Design.Data

Zestaw:: System.Design.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje parametrów 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 jest wyświetlane.

connection: DesignerDataConnection

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

name: String

Nazwa nowego wpisu konfiguracji połączenia.

Zwraca

DesignerDataConnection

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

Uwagi

Metoda ConfigureConnection zapisuje połączenie w pliku konfiguracji aplikacji. Parametry połączenia i nazwa dostawcy są zapisywane w elemencie konfiguracji connectionStrings (ASP.NET Ustawienia Schema) o nazwie zgodnie z name parametrem . Właściwość Name parametru connection jest ignorowana.

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

Wyjątek	Przyczyna
ArgumentException	W pliku konfiguracji aplikacji istnieje zduplikowana nazwa.
FileNotFoundException, UnauthorizedAccessException lub 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 przestrzeni nazw do odczytu i zapisu System.Configuration pliku konfiguracji aplikacji. Klasa ConnectionStringsSection odczyta i zapisze element konfiguracji connectionStrings (ASP.NET Ustawienia Schema).

Dotyczy