OracleConnection.ConnectionString Properti

Definisi

Ruang nama:

System.Data.OracleClient

Rakitan:

System.Data.OracleClient.dll

Mendapatkan atau mengatur string yang digunakan untuk membuka database Oracle.

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

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Nilai Properti

String

Oracle string koneksi yang menyertakan pengaturan, seperti nama server, diperlukan untuk membuat koneksi awal. Nilai default adalah string kosong ("").

Atribut

SettingsBindableAttribute

Contoh

Contoh berikut membuat OracleConnection dan mengatur beberapa propertinya dalam string koneksi.

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}

Public Sub CreateOracleConnection()
    Dim connectionString As String = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub

Keterangan

ConnectionString dapat diatur hanya ketika koneksi ditutup.

Anda bisa menggunakan ConnectionString properti untuk menyambungkan ke database. Contoh berikut mengilustrasikan string koneksi umum.

"Data Source=Oracle8i;Integrated Security=yes"  

Banyak pengaturan yang ditentukan dalam string memiliki properti baca-saja yang sesuai (misalnya, Data Source=MyServer, yang sesuai dengan DataSource properti ). Ketika string koneksi diatur, semua properti ini diperbarui, kecuali kesalahan terdeteksi, dalam hal ini tidak ada properti yang diperbarui. OracleConnection properti hanya mengembalikan pengaturan default atau pengaturan yang ditentukan dalam ConnectionString.

Mengatur ConnectionString ulang pada koneksi tertutup mengatur ulang semua nilai string koneksi (dan properti terkait), termasuk kata sandi.

string koneksi diurai segera setelah ditetapkan. Jika penguraian mengungkapkan kesalahan dalam sintaks, pengecualian run-time, seperti ArgumentException, dihasilkan. Kesalahan lain hanya dapat ditemukan ketika upaya dilakukan untuk membuka koneksi.

Format dasar string koneksi adalah serangkaian pasangan kata kunci/nilai yang dipisahkan oleh titik koma. Tanda sama dengan (=) menghubungkan setiap kata kunci dan nilainya. Untuk menyertakan nilai yang berisi tanda titik koma, karakter tanda kutip tunggal, atau karakter tanda kutip ganda, nilai harus diapit dalam tanda kutip ganda. Jika nilai berisi titik koma dan karakter tanda kutip ganda, nilai dapat diapit dalam tanda kutip tunggal. Kutipan tunggal juga berguna jika nilai dimulai dengan karakter tanda kutip ganda. Sebaliknya, kuotasi ganda dapat digunakan jika nilai dimulai dengan satu kuotasi. Jika nilai berisi karakter tanda kutip tunggal dan tanda kutip ganda, karakter kutipan yang digunakan untuk mengapit nilai harus digandakan setiap kali nilai terjadi dalam nilai.

Untuk menyertakan spasi sebelumnya atau di belakang dalam nilai string, nilai harus diapit dalam tanda kutip tunggal atau tanda kutip ganda. Setiap spasi di depan atau di belakang di sekitar nilai bilangan bulat, Boolean, atau enumerasi diabaikan, bahkan jika diapit dalam tanda kutip. Namun, spasi dalam kata kunci atau nilai harfiah string dipertahankan. Tanda kutip tunggal atau ganda dapat digunakan dalam string koneksi tanpa menggunakan pemisah kecuali karakter kutipan adalah karakter pertama atau terakhir dalam nilai, misalnya, Data Source= my'Server atau Data Source= my"Server.

Untuk menyertakan tanda sama dengan (=) dalam kata kunci atau nilai, itu harus didahului oleh tanda sama dengan lainnya. Misalnya, dalam string koneksi hipotetis

"key==word=value"  

kata kuncinya adalah "key=word" dan nilainya adalah "value".

Jika kata kunci tertentu dalam pasangan kata kunci/nilai terjadi lebih dari sekali dalam string koneksi, kemunculan terakhir digunakan dalam kumpulan nilai.

Kata kunci tidak peka huruf besar/kecil.

Tabel berikut mencantumkan nama yang valid untuk nilai dalam ConnectionString.

Nama	Default	Deskripsi
Sumber Data. -atau- Server		Nama atau alamat jaringan instans Oracle yang akan disambungkan.
Keamanan Terintegrasi	'false'	Apakah koneksi akan menjadi koneksi aman atau tidak. Nilai yang dikenali adalah true (sangat disarankan), false, yes, dan no.
Kata sandi		Kata sandi untuk masuk akun Oracle. Untuk mempertahankan tingkat keamanan yang tinggi, kami sangat menyarankan Anda menggunakan kata kunci Keamanan Terintegrasi sebagai gantinya.
Pertahankan Info Keamanan	'false'	Ketika diatur ke false atau no (sangat disarankan), informasi sensitif keamanan seperti kata sandi tidak dikembalikan sebagai bagian dari koneksi jika koneksi terbuka atau pernah terbuka State. Mengatur ulang string koneksi mengatur ulang semua nilai string koneksi, termasuk kata sandi. Nilai yang dikenali adalah true, false, yes, dan no.
Unicode	'false'	Menentukan apakah Penyedia Data .NET Framework untuk Oracle menggunakan panggilan API mode UTF16. Kata kunci ini diabaikan kecuali saat menggunakan perangkat lunak klien Oracle9i.
ID Pengguna		Akun masuk Oracle. Untuk mempertahankan tingkat keamanan yang tinggi, kami sangat menyarankan Anda menggunakan kata kunci Keamanan Terintegrasi sebagai gantinya.

Tabel berikut mencantumkan nama yang valid untuk nilai pengumpulan koneksi dalam ConnectionString.

Nama	Default	Deskripsi
Masa Pakai Koneksi	0	Saat koneksi dikembalikan ke kumpulan, waktu pembuatannya dibandingkan dengan waktu saat ini, dan koneksi dimusnahkan jika rentang waktu tersebut (dalam detik) melebihi nilai yang ditentukan oleh Connection Lifetime. Ini berguna dalam konfigurasi berkluster untuk memaksa penyeimbangan beban antara server yang sedang berjalan dan server yang baru saja online. Nilai nol menyebabkan koneksi terkumpul memiliki batas waktu koneksi maksimum.
Daftar	'true'	Ketika true atau yes, pengumpul secara otomatis mendaftarkan koneksi dalam konteks transaksi alur pembuatan saat ini. Nilai yang dikenali adalah true, false, yes, dan no.
Ukuran Kumpulan Maks	100	Jumlah maksimum koneksi yang diizinkan dalam kumpulan. Max Pool Size Mengatur nilai ConnectionString dapat memengaruhi performa. Jika Anda berencana untuk membuat dan secara aktif menggunakan lebih dari 100 koneksi, Anda harus meningkatkan Max Pool Size ke nilai yang memperkirakan penggunaan koneksi status stabil untuk aplikasi.
Ukuran Kumpulan Min	0	Jumlah minimum koneksi yang diizinkan dalam kumpulan.
Penggabungan	'true'	Ketika true atau yes, OracleConnection objek diambil dari kumpulan yang sesuai, atau jika perlu, dibuat dan ditambahkan ke kumpulan yang sesuai. Nilai yang dikenali adalah true, false, yes, dan no.

Saat mengatur kata kunci atau nilai pengumpulan koneksi yang memerlukan nilai Boolean, Anda dapat menggunakan 'ya' alih-alih 'true', dan 'tidak' alih-alih 'false'. Nilai bilangan bulat direpresentasikan sebagai string.