OracleConnection.ConnectionString Özellik

Tanım

Ad Alanı:

System.Data.OracleClient

Bütünleştirilmiş Kod:

System.Data.OracleClient.dll

Oracle veritabanını açmak için kullanılan dizeyi alır veya ayarlar.

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

Özellik Değeri

String

İlk bağlantıyı kurmak için gereken sunucu adı gibi ayarları içeren Oracle bağlantı dizesi. Varsayılan değer boş bir dizedir ("").

Öznitelikler

SettingsBindableAttribute

Açıklamalar

ConnectionString yalnızca bağlantı kapatıldığında ayarlanabilir.

bir veritabanına bağlanmak için özelliğini kullanabilirsiniz ConnectionString .

Dizede belirtilen ayarların birçoğuna karşılık gelen salt okunur özellikler (örneğin, Data Source=MyServerözelliğine DataSource karşılık gelen ) vardır. Bağlantı dizesi ayarlandığında, bir hata algılanmadığı sürece bu özelliklerin tümü güncelleştirilir ve bu durumda özelliklerden hiçbiri güncelleştirilmez. OracleConnection özellikleri yalnızca varsayılan ayarları veya içinde ConnectionStringbelirtilen ayarları döndürür.

kapalı bir bağlantının sıfırlanması ConnectionString , parola da dahil olmak üzere tüm bağlantı dizesi değerlerini (ve ilgili özellikleri) sıfırlar.

Bağlantı dizesi ayarlandıktan hemen sonra ayrıştırılır. Ayrıştırma söz diziminde hatalar ortaya çıkarsa, gibi ArgumentExceptionbir çalışma zamanı özel durumu oluşturulur. Diğer hatalar yalnızca bağlantıyı açma girişiminde bulunulduğunda bulunabilir.

Bağlantı dizesinin temel biçimi, noktalı virgülle ayrılmış bir dizi anahtar sözcük/değer çiftidir. eşittir işareti (=) her anahtar sözcüğü ve değerini bağlar. Noktalı virgül, tek tırnak karakteri veya çift tırnak karakteri içeren değerleri eklemek için, değerin çift tırnak içine alınması gerekir. Değer hem noktalı virgül hem de çift tırnak karakteri içeriyorsa, değer tek tırnak içine alınabilir. Değer çift tırnak karakteriyle başlıyorsa tek tırnak da yararlıdır. Buna karşılık, değer tek bir tırnakla başlıyorsa çift tırnak kullanılabilir. Değer hem tek tırnak hem de çift tırnak karakterleri içeriyorsa, değerin içine almak için kullanılan tırnak karakteri, değer içinde her oluştuğunda iki katına çıkarılmalıdır.

Dize değerine önceki veya sondaki boşlukları eklemek için, değerin tek tırnak içine alınması veya çift tırnak içine alınması gerekir. Tamsayı, Boole veya numaralandırılmış değerlerin etrafındaki baştaki veya sondaki boşluklar, tırnak içine alınmış olsa bile yoksayılır. Ancak, bir dize değişmez anahtar sözcüğü veya değeri içindeki boşluklar korunur. Bir tırnak karakteri değerin ilk veya son karakteri (örneğin, Data Source= my'Server veya Data Source= my"Server) olmadığı sürece, tek veya çift tırnaklar, sınırlayıcılar kullanılmadan bir bağlantı dizesi içinde kullanılabilir.

Bir anahtar sözcük veya değere eşittir işareti (=) eklemek için, önünde başka bir eşittir işareti bulunmalıdır. Örneğin, varsayımsal bağlantı dizesinde

"key==word=value"

anahtar sözcüğü "key=word" ve değer ise "value" olur.

Bir anahtar sözcük/değer çiftindeki belirli bir anahtar sözcük bir bağlantı dizesinde birden çok kez gerçekleşirse, değer kümesinde son oluşum kullanılır.

Anahtar sözcükler büyük/küçük harfe duyarlı değildir.

Aşağıdaki tabloda içindeki değerler için geçerli adlar listelemektedir ConnectionString.

İsim	Varsayılan	Açıklama
Veri Kaynağı -veya- Server		Bağlanacak Oracle örneğinin adı veya ağ adresi.
Tümleşik Güvenlik	'false'	Bağlantının güvenli bir bağlantı olup olmadığı. Tanınan değerler şunlardır true (kesinlikle önerilir), false, yesve no.
Parola		Oracle hesabının oturum açma parolası. Yüksek düzeyde güvenlik sağlamak için bunun yerine Tümleşik Güvenlik anahtar sözcüğünü kullanmanızı kesinlikle öneririz.
Güvenlik Bilgilerini Kalıcı Hale	'false'	veya no olarak ayarlandığında false (kesinlikle önerilir), bağlantı açıksa veya açık durumdaysa parola gibi güvenlik açısından hassas bilgiler bağlantının bir Stateparçası olarak döndürülmüyor. Bağlantı dizesi sıfırlandığında, parola da dahil olmak üzere tüm bağlantı dizesi değerleri sıfırlanır. Tanınan değerler , true, falseve yesdeğerleridirno.
Unicode	'false'	Oracle için .NET Framework Veri Sağlayıcısı'nın UTF16 modu API çağrılarını kullanıp kullanmadığını belirtir. Oracle9i istemci yazılımı kullanıldığı durumlar dışında bu anahtar sözcük yoksayılır.
Kullanıcı kimliği		Oracle oturum açma hesabı. Yüksek düzeyde güvenlik sağlamak için bunun yerine Tümleşik Güvenlik anahtar sözcüğünü kullanmanızı kesinlikle öneririz.

Aşağıdaki tabloda, içindeki ConnectionStringbağlantı havuzu değerleri için geçerli adlar listeleniyor.

İsim	Varsayılan	Açıklama
Bağlantı Ömrü	0	Havuza bir bağlantı döndürülürse, oluşturma süresi geçerli saatle karşılaştırılır ve bu zaman aralığı (saniye cinsinden) tarafından Connection Lifetimebelirtilen değeri aşarsa bağlantı yok edilir. Bu, kümelenmiş yapılandırmalarda çalışan bir sunucu ile yeni çevrimiçi duruma getirilmiş bir sunucu arasında yük dengelemeye zorlamak için kullanışlıdır. Sıfır değeri, havuza alınan bağlantıların bağlantı zaman aşımı üst sınırına sahip olmasına neden olur.
Askere	'true'	veya yesolduğundatrue, havuz oluşturucu bağlantıyı oluşturma iş parçacığının geçerli işlem bağlamında otomatik olarak listeler. Tanınan değerler , true, falseve yesdeğerleridirno.
En Büyük Havuz Boyutu	100	Havuzda izin verilen en fazla bağlantı sayısı. değerinin Max Pool SizeConnectionString ayarlanması performansı etkileyebilir. 100'den fazla bağlantı oluşturmayı ve etkin bir şekilde kullanmayı planlıyorsanız, uygulamanın kararlı durum bağlantı kullanımına yakın bir değere yükseltmeniz Max Pool Size gerekir.
En Düşük Havuz Boyutu	0	Havuzda izin verilen en az bağlantı sayısı.
Biriktirme	'true'	veya yesOracleConnection olduğundatrue, nesne uygun havuzdan çekilir veya gerekirse oluşturulur ve uygun havuza eklenir. Tanınan değerler , true, falseve yesdeğerleridirno.

Boole değeri gerektiren anahtar sözcük veya bağlantı havuzu değerlerini ayarlarken, 'true' yerine 'evet' ve 'false' yerine 'hayır' kullanabilirsiniz. Tamsayı değerleri dize olarak temsil edilir.