IDataEnvironment.ConfigureConnection Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menulis string koneksi ke file konfigurasi aplikasi.
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 DesignerDataConnectionParameter
- owner
- IWin32Window
Jendela induk untuk dialog, jika ada.
- connection
- DesignerDataConnection
Objek DesignerDataConnection yang berisi data koneksi untuk disimpan.
- name
- String
Nama entri konfigurasi koneksi baru.
Mengembalikan
Objek DesignerDataConnection yang berisi data koneksi tersimpan dengan properti diatur Name ke name, dan IsConfigured properti diatur ke true.
Keterangan
Metode ini ConfigureConnection menulis koneksi ke file konfigurasi aplikasi. String koneksi dan nama penyedia ditulis ke elemen konfigurasi connectionStrings Element (ASP.NET Settings Schema) bernama sesuai dengan name parameter . Properti Nameconnection parameter diabaikan.
ConfigureConnection Implementasi metode harus melemparkan pengecualian berikut.
| Pengecualian | Alasan |
|---|---|
| ArgumentException | Nama duplikat ada dalam file konfigurasi aplikasi. |
| FileNotFoundException, UnauthorizedAccessException, atau pengecualian IO file lain yang sesuai. | File konfigurasi aplikasi tidak dapat diperbarui. Implementasi metode Anda ConfigureConnection harus memberikan pengecualian yang sesuai. |
| CheckoutException | File konfigurasi aplikasi tidak dapat dicek keluar dari sistem kontrol sumber. |
Pertimbangkan untuk menggunakan API manajemen konfigurasi di System.Configuration namespace layanan untuk membaca dan menulis file konfigurasi aplikasi. Kelas ConnectionStringsSection akan membaca dan menulis elemen konfigurasi connectionStrings Element (ASP.NET Settings Schema).
