Condividi tramite


IDataEnvironment.ConfigureConnection Metodo

Definizione

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.DesignerDataConnection
Public Function ConfigureConnection (owner As IWin32Window, connection As DesignerDataConnection, name As String) As DesignerDataConnection

Parametri

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).

Si applica a