IDataEnvironment.ConfigureConnection Metodo

Definizione

Spazio dei nomi:

System.ComponentModel.Design.Data

Assembly:

System.Design.dll

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

DesignerDataConnection

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