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 la finestra di dialogo, se presente.

connection

DesignerDataConnection

Oggetto DesignerDataConnection contenente 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 Name proprietà impostata su e la IsConfigured proprietà impostata namesu 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 di configurazione connectionStrings Element (ASP.NET Settings Schema) denominato in base al name parametro . La Name proprietà del connection parametro viene ignorata.

Le implementazioni del ConfigureConnection metodo devono generare le eccezioni seguenti.

Eccezione	Ragione
ArgumentException	Esiste un nome duplicato nel file di configurazione dell'applicazione.
FileNotFoundExceptionEccezione UnauthorizedAccessExceptiondi I/O di file , o altro file appropriato.	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.

Prendere in considerazione l'uso delle 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 Element (ASP.NET Settings Schema).