OracleConnection.ConnectionString Özellik

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

SettingsBindableAttribute

Ö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.

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

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