OracleConnection.ConnectionString Özellik

Tanım

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

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public string ConnectionString { get; set; }
public override string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
Public Property ConnectionString As String
Public Overrides Property ConnectionString As String

Özellik Değeri

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

Uygulamalar

Öznitelikler

Örnekler

Aşağıdaki örnek bir OracleConnection oluşturur ve bağlantı dizesi bazı özelliklerini ayarlar.

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

Açıklamalar

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

bir veritabanına bağlanmak için özelliğini kullanabilirsiniz ConnectionString . Aşağıdaki örnekte tipik bir bağlantı dizesi gösterilmektedir.

"Data Source=Oracle8i;Integrated Security=yes"  

Dizede belirtilen ayarların çoğunun karşılık gelen salt okunur özellikleri vardır (örneğin, Data Source=MyServerözelliğine DataSource karşılık gelen ). bağlantı dizesi ayarlandığında, bir hata algılanmadığı sürece bu özelliklerin tümü güncelleştirilir ve bu durumda özelliklerin 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 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ı dizesi 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 eklenebilir. Değer çift tırnak karakteriyle başlıyorsa tek tırnak da yararlıdır. Buna karşılık, değer tek tırnakla başlıyorsa çift tırnak kullanılabilir. Değer hem tek tırnaklı 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 gerçekleştiğinde 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 sonundaki boşluklar tırnak içine alınmış olsa bile yoksayılır. Ancak, dize değişmez değeri anahtar sözcüğü veya değeri içindeki boşluklar korunur. Tek veya çift tırnaklar, bir tırnak karakteri değerdeki ilk veya son karakter (örneğin veya Data Source= my'ServerData Source= my"Server) olmadığı sürece 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ı dizesi

"key==word=value"  

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

Anahtar sözcük/değer çiftindeki belirli bir anahtar sözcük bir bağlantı dizesi 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 ConnectionStringdeğerler için geçerli adlar listelenmiştir.

Name Varsayılan Açıklama
Veri Kaynağı

-veya-

Sunucu
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 (kesinlikle önerilir), false, yesve nodeğerleridir true .
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 olduğunda 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 , false, yesve nodeğerleridirtrue.
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ılıyorsa 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 listelenmiştir.

Name 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, çalışan bir sunucu ile yeni çevrimiçi duruma getirilen bir sunucu arasında yük dengelemeye zorlamak için kümelenmiş yapılandırmalarda yararlıdır.

Sıfır değeri, havuza alınan bağlantıların en fazla bağlantı zaman aşımı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 , false, yesve nodeğerleridirtrue.
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 yesolduğundatrue, OracleConnection nesne uygun havuzdan çizilir veya gerekirse oluşturulur ve uygun havuza eklenir.

Tanınan değerler , false, yesve nodeğerleridirtrue.

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

Şunlara uygulanır