IDataEnvironment.ConfigureConnection Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee schrijft u een verbindingsreeks naar het configuratiebestand van de toepassing.
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.DesignerDataConnectionPublic Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnectionParameters
- owner
- IWin32Window
Het bovenliggende venster voor het dialoogvenster, indien van toepassing.
- connection
- DesignerDataConnection
Een DesignerDataConnection object met de verbindingsgegevens die moeten worden opgeslagen.
- name
- String
De naam van de nieuwe verbindingsconfiguratievermelding.
Retouren
Een DesignerDataConnection object met de opgeslagen verbindingsgegevens waarop de Name eigenschap is ingesteld nameen de IsConfigured eigenschap is ingesteld op true.
Opmerkingen
De ConfigureConnection methode schrijft een verbinding met het configuratiebestand van de toepassing. De verbindingsreeks- en providernaam worden naar het connectionStrings-element (ASP.NET-instellingenschema) configuratie-element geschreven volgens de parameter name. De Name eigenschap van de connection parameter wordt genegeerd.
Implementaties van de ConfigureConnection methode moeten de volgende uitzonderingen genereren.
| Exception | Reden |
|---|---|
| ArgumentException | Er bestaat een dubbele naam in het configuratiebestand van de toepassing. |
| FileNotFoundException, UnauthorizedAccessExceptionof een andere geschikte io-uitzondering voor bestanden. | Het configuratiebestand van de toepassing kan niet worden bijgewerkt. Uw ConfigureConnection methode-implementatie moet een passende uitzondering genereren. |
| CheckoutException | Het configuratiebestand van de toepassing kan niet worden uitgecheckt vanuit het broncodebeheersysteem. |
Overweeg het gebruik van de API's voor configuratiebeheer in de System.Configuration naamruimte om het configuratiebestand van de toepassing te lezen en te schrijven. De klasse ConnectionStringsSection leest en schrijft het connectionStrings-element (ASP.NET-instellingenschema) configuratie-element.
