共用方式為


OracleConnection.ConnectionString 屬性

定義

取得或設定用來開啟 Oracle 資料庫的字串。

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

屬性值

Oracle 連接字串,包含建立初始連接所需要的設定,例如伺服器名稱。 預設值為空字串 ("")。

實作

屬性

範例

下列範例會建立 ,OracleConnection並在 連接字串 中設定其部分屬性。

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

備註

ConnectionString只有在連線關閉時,才能設定 。

您可以使用 ConnectionString 屬性來連線到資料庫。 下列範例說明典型的 連接字串。

"Data Source=Oracle8i;Integrated Security=yes"  

字串中指定的許多設定都有對應的唯讀屬性 (例如 , Data Source=MyServer其對應於 DataSource 屬性) 。 設定 連接字串 時,除非偵測到錯誤,否則會更新所有這些屬性,在此情況下不會更新任何屬性。 OracleConnection 屬性只會傳回預設設定或 中指定的 ConnectionString設定。

重設關閉連線上的 會ConnectionString重設所有 連接字串 值, (和相關屬性) ,包括密碼。

設定之後,會立即剖析 連接字串。 如果剖析顯示語法中的錯誤,則會產生執行時例外狀況,例如 ArgumentException。 只有在嘗試開啟連線時,才能找到其他錯誤。

連接字串 的基本格式是以分號分隔的一系列關鍵詞/值組。 等號 (=) 會連接每個關鍵字和其值。 若要包含包含分號、單引號字元或雙引號字元的值,值必須以雙引號括住。 如果值同時包含分號和雙引號字元,則可以以單引號括住值。 如果值以雙引號字元開頭,則單引號也很有用。 相反地,如果值以單引號開頭,則可以使用雙引號。 如果值同時包含單引號和雙引號字元,則每次在值內發生值時,用來括住值的引號字元都必須加倍。

若要在字串值中包含前置或尾端空格,值必須以單引號或雙引弧括住。 整數、布爾值或列舉值周圍的任何前置或尾端空格都會被忽略,即使以引號括住也一樣。 不過,會保留字串常值關鍵詞或值內的空格。 單引號或雙引號可以在 連接字串 內使用,而不使用分隔符,除非引號字元是值中的第一個或最後一個字元,例如 Data Source= my'ServerData Source= my"Server

若要在關鍵詞或值中包含等號 (=) ,它前面必須加上另一個等號。 例如,在假設 連接字串

"key==word=value"  

關鍵詞為 “key=word”,而值為 “value”。

如果關鍵詞/值組中的特定關鍵詞在 連接字串 中發生一次以上,則會在值集中使用最後一個出現專案。

關鍵詞不區分大小寫。

下表列出 中 ConnectionString值的有效名稱。

名稱 預設 描述
資料來源

-或-

伺服器
要連線之 Oracle 實例的名稱或網路位址。
整合式安全性 'false' 連線是否會是安全連線。

辨識的值 true (強烈建議) 、 falseyesno
密碼 Oracle 帳戶登入的密碼。 為了維持高層級的安全性,強烈建議您改用整合式安全性關鍵詞。
保存安全性資訊 'false' 當設定為 false 或 (強烈建議) 時,如果連接已開啟或 no 曾經處於開啟 State狀態,則不會傳回密碼之類的安全性敏感性資訊作為連線的一部分。 重設 連接字串 會重設所有 連接字串 值,包括密碼。

可辨識的值為 truefalseyesno
Unicode 'false' 指定 oracle 的數據提供者是否使用 UTF16 模式 API 呼叫 .NET Framework。 除非使用 Oracle9i 用戶端軟體,否則會忽略此關鍵詞。
使用者識別碼 Oracle 登入帳戶。 為了維持高層級的安全性,強烈建議您改用整合式安全性關鍵詞。

下表列出 內 ConnectionString連接共用值的有效名稱。

名稱 預設 描述
連線存留期 0 當連接傳回集區時,會將其建立時間與目前時間進行比較,如果該時間範圍 (秒) 超過 Connection Lifetime 指定的值,則會損毀連接。 這在叢集組態中很有用,可在執行中伺服器與剛連線的伺服器之間強制負載平衡。

值為零會導致集區連線具有最大連線逾時。
Enlist 'true' 當 或 yestrue,共享器會自動在建立線程的目前交易內容中登記連接。

可辨識的值為 truefalseyesno
Max Pool Size 100 集區中所允許的最大連接數。 Max Pool Size設定的值ConnectionString可能會影響效能。 如果您打算建立並主動使用超過100個連線,您應該增加 Max Pool Size 一個值,以近似應用程式的穩定狀態聯機使用量。
Min Pool Size 0 集區中允許的連線數目下限。
Pooling 'true' 當 或 yestrueOracleConnection物件會從適當的集區繪製,或視需要建立並新增至適當的集區。

可辨識的值為 truefalseyesno

設定需要布爾值的關鍵詞或連接共用值時,您可以使用 'yes' 而不是 'true',而 'no' 而不是 'false'。 整數值會以字串表示。

適用於