OdbcConnection.ConnectionString Properti

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-preview.5.24306.7

Sumber:

OdbcConnection.cs

Mendapatkan atau mengatur string yang digunakan untuk membuka sumber data.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Nilai Properti

String

Driver ODBC string koneksi yang menyertakan pengaturan, seperti nama sumber data, diperlukan untuk membuat koneksi awal. Nilai default adalah string kosong (""). Panjang maksimum adalah 1024 karakter.

Keterangan

Properti ConnectionString ini dirancang agar sesuai dengan format odbc string koneksi sedekat mungkin. ConnectionString dapat diatur hanya ketika koneksi ditutup, dan segera setelah diatur diteruskan, tidak berubah, ke Driver Manager dan driver yang mendasar. Oleh karena itu, sintaks untuk ConnectionString harus sama persis dengan apa yang didukung Driver Manager dan driver yang mendasar.

Anda dapat menggunakan ConnectionString properti untuk menyambungkan ke berbagai sumber data. Ini termasuk nama sumber data ODBC (DSN). Contoh berikut mengilustrasikan beberapa kemungkinan string koneksi.

"Driver={SQL Server};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;"

"Driver={Microsoft ODBC for Oracle};Server=ORACLE8i7;Persist Security Info=False;Trusted_Connection=Yes"

"Driver={Microsoft Access Driver (*.mdb)};DBQ=c:\bin\Northwind.mdb"

"Driver={Microsoft Excel Driver (*.xls)};DBQ=c:\bin\book1.xls"

"Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=c:\bin"

"DSN=dsnname"

Catatan

Penyedia Data .NET Framework untuk ODBC tidak mendukung Persist Security Info kata kunci yang didukung oleh penyedia data .NET Framework lainnya. Namun, properti berperilaku ConnectionString seolah-olah Persist Security Info diatur ke false. Ini berarti Anda tidak dapat mengambil kata sandi dari ConnectionString properti jika koneksi telah dibuka. ConnectionString Ketika properti dibaca dari OdbcConnection objek yang telah dibuka, string koneksi dikembalikan dikurangi kata sandi. Anda tidak dapat mengubah perilaku ini; oleh karena itu, jika aplikasi memerlukan kata sandi, simpan secara terpisah sebelum memanggil Open.

Banyak pengaturan yang ditentukan dalam string memiliki properti baca-saja yang sesuai (misalnya, Server=(local), yang sesuai dengan DataSource properti ). Properti ini diperbarui setelah koneksi dibuka, kecuali ketika kesalahan terdeteksi. Dalam hal ini, tidak ada properti yang diperbarui. OdbcConnection properti (seperti Database) hanya mengembalikan pengaturan default atau pengaturan yang ditentukan dalam ConnectionString.

Dalam Microsoft .NET Framework versi 1.0, validasi string koneksi tidak terjadi sampai aplikasi memanggil Open metode . Adalah tanggung jawab driver ODBC yang mendasar untuk memvalidasi string koneksi. Jika string koneksi berisi properti yang tidak valid atau tidak didukung, driver dapat menaikkan OdbcException pada durasi.

Namun, dalam versi .NET Framework 1.1 dan yang lebih baru, beberapa validasi dasar string koneksi terjadi segera setelah Anda mengatur ConnectionString properti . Pada saat itu, penyedia data memverifikasi bahwa string koneksi memenuhi "kata kunci=nilai;..." format, tetapi tidak memverifikasi apakah kata kunci atau nilai valid. Verifikasi yang tersisa dilakukan oleh driver ODBC yang mendasar Open ketika aplikasi memanggil metode .

String koneksi ODBC memiliki sintaks berikut:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]
attribute-keyword ::= DSN | UID | PWD
 | driver-defined-attribute-keyword
attribute-value ::= character-string
driver-defined-attribute-keyword ::= identifier

di mana character-string memiliki nol atau lebih karakter; identifier memiliki satu atau beberapa karakter; attribute-keyword tidak peka huruf besar/kecil; attribute-value dan nilai kata kunci DSN tidak hanya terdiri dari kosong.

Karena tata bahasa file string koneksi dan inisialisasi, kata kunci dan nilai atribut harus dihindari yang berisi karakter []{}(),;? *=!@ tidak diapit kurung kurawal. Nilai kata kunci DSN tidak boleh hanya terdiri dari kosong dan tidak boleh berisi kosong di depannya. Karena tata bahasa informasi sistem, kata kunci dan nama sumber data tidak boleh berisi karakter garis miring terbelakang (\).

Aplikasi tidak perlu menambahkan kurung kurawal di sekitar nilai atribut setelah kata kunci Driver kecuali atribut berisi titik koma (;), dalam hal ini kurung kurawal diperlukan. Jika nilai atribut yang diterima driver menyertakan kurung kurawal, driver tidak boleh menghapusnya tetapi harus menjadi bagian dari string koneksi yang dikembalikan.

Nilai DSN atau string koneksi diapit kurung kurawal ({}) yang berisi salah satu karakter []{}(),;? *=!@ diteruskan utuh ke driver. Namun, ketika Anda menggunakan karakter ini dalam kata kunci, Driver Manager mengembalikan kesalahan saat Anda bekerja dengan DSN file, tetapi meneruskan string koneksi ke driver untuk string koneksi reguler. Hindari menggunakan kurung kurawal yang disematkan dalam nilai kata kunci.

string koneksi dapat mencakup sejumlah kata kunci yang ditentukan driver. Karena kata kunci DRIVER tidak menggunakan informasi dari sistem, driver harus menentukan kata kunci yang cukup sehingga driver dapat terhubung ke sumber data hanya menggunakan informasi dalam string koneksi. Driver menentukan kata kunci mana yang diperlukan untuk menyambungkan ke sumber data.

Jika ada kata kunci yang diulang dalam string koneksi, tidak ada jaminan nilai mana yang akan dipilih.

Catatan

Jika driver ODBC mendukung string koneksi yang lebih panjang dari 1024 karakter, Anda dapat menggunakan nama sumber data (DSN) untuk melebihi batasan panjang maksimum.

Lihat juga

• Menyambungkan ke Sumber Data