IDataEnvironment.ConfigureConnection Metoda

Definice

Obor názvů:

System.ComponentModel.Design.Data

Sestavení:

System.Design.dll

Zapíše připojovací řetězec do konfiguračního souboru aplikace.

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

Nadřazené okno dialogového okna, pokud existuje.

connection

DesignerDataConnection

Objekt DesignerDataConnection obsahující data připojení, která se mají uložit.

name

String

Název nové položky konfigurace připojení.

Návraty

DesignerDataConnection

Objekt DesignerDataConnection obsahující uložená data připojení s vlastností nastavenou Name na namea vlastnost nastavenou IsConfigured na true.

Poznámky

Metoda ConfigureConnection zapíše připojení ke konfiguračnímu souboru aplikace. Připojovací řetězec a název zprostředkovatele jsou zapsány do elementu konfigurace connectionStrings Element (ASP.NET Settings Schema) s názvem podle parametru name . Vlastnost Name parametru connection je ignorována.

ConfigureConnection Implementace metody by měly vyvolat následující výjimky.

Výjimka	Důvod
ArgumentException	V konfiguračním souboru aplikace existuje duplicitní název.
FileNotFoundException, UnauthorizedAccessExceptionnebo jinou příslušnou výjimku vstupně-výstupních operací souboru.	Konfigurační soubor aplikace nelze aktualizovat. Implementace ConfigureConnection vaší metody by měla vyvolat příslušnou výjimku.
CheckoutException	Konfigurační soubor aplikace nelze rezervovat ze systému správy zdrojového kódu.

Zvažte použití rozhraní API pro správu konfigurace v System.Configuration oboru názvů ke čtení a zápisu konfiguračního souboru aplikace. Třída ConnectionStringsSection přečte a zapíše element konfigurace connectionStrings Element (ASP.NET Settings Schema).