IDataEnvironment.ConfigureConnection Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Scrive una stringa di connessione nel file di configurazione dell'applicazione.
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 DesignerDataConnectionParametri
- owner
- IWin32Window
Finestra padre per l'eventuale finestra di dialogo.
- connection
- DesignerDataConnection
Oggetto DesignerDataConnection contenete i dati di connessione da salvare.
- name
- String
Nome della nuova voce di configurazione della connessione.
Restituisce
Oggetto DesignerDataConnection contenente i dati di connessione salvati con la proprietà Name impostata su name e la proprietà IsConfigured impostata su true.
Commenti
Il ConfigureConnection metodo scrive una connessione al file di configurazione dell'applicazione. La stringa di connessione e il nome del provider vengono scritti nell'elemento connectionStrings (ASP.NET Settings Schema) denominato secondo il name parametro . La Name proprietà del connection parametro viene ignorata.
Le implementazioni del ConfigureConnection metodo devono generare le eccezioni seguenti.
| Eccezione | Motivo |
|---|---|
| ArgumentException | Un nome duplicato esiste nel file di configurazione dell'applicazione. |
| FileNotFoundException, UnauthorizedAccessExceptiono un'altra eccezione di I/O file appropriata. | Impossibile aggiornare il file di configurazione dell'applicazione. L'implementazione del ConfigureConnection metodo deve generare un'eccezione appropriata. |
| CheckoutException | Il file di configurazione dell'applicazione non può essere estratto dal sistema di controllo del codice sorgente. |
È consigliabile usare le API di gestione della configurazione nello System.Configuration spazio dei nomi per leggere e scrivere il file di configurazione dell'applicazione. La ConnectionStringsSection classe leggerà e scriverà l'elemento di configurazione connectionStrings (ASP.NET Settings Schema).
