OracleConnection.ConnectionString 屬性

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

取得或設定用來開啟 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

屬性值

String

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

屬性

SettingsBindableAttribute

範例

下列範例會建立 ，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'Server 或 Data Source= my"Server。

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

"key==word=value"  

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

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

關鍵詞不區分大小寫。

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

名稱	預設	描述
資料來源 -或- 伺服器		要連線之 Oracle 實例的名稱或網路位址。
整合式安全性	'false'	連線是否會是安全連線。 辨識的值 true (強烈建議) 、 falseyes和 no。
密碼		Oracle 帳戶登入的密碼。 為了維持高層級的安全性，強烈建議您改用整合式安全性關鍵詞。
保存安全性資訊	'false'	當設定為 false 或 (強烈建議) 時，如果連接已開啟或 no 曾經處於開啟 State狀態，則不會傳回密碼之類的安全性敏感性資訊作為連線的一部分。 重設 連接字串 會重設所有 連接字串 值，包括密碼。 可辨識的值為 true、false、yes 和 no。
Unicode	'false'	指定 oracle 的數據提供者是否使用 UTF16 模式 API 呼叫 .NET Framework。 除非使用 Oracle9i 用戶端軟體，否則會忽略此關鍵詞。
使用者識別碼		Oracle 登入帳戶。 為了維持高層級的安全性，強烈建議您改用整合式安全性關鍵詞。

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

名稱	預設	描述
連線存留期	0	當連接傳回集區時，會將其建立時間與目前時間進行比較，如果該時間範圍 (秒) 超過 Connection Lifetime 指定的值，則會損毀連接。 這在叢集組態中很有用，可在執行中伺服器與剛連線的伺服器之間強制負載平衡。 值為零會導致集區連線具有最大連線逾時。
Enlist	'true'	當 或 yes時true，共享器會自動在建立線程的目前交易內容中登記連接。 可辨識的值為 true、false、yes 和 no。
Max Pool Size	100	集區中所允許的最大連接數。 Max Pool Size設定的值ConnectionString可能會影響效能。 如果您打算建立並主動使用超過100個連線，您應該增加 Max Pool Size 一個值，以近似應用程式的穩定狀態聯機使用量。
Min Pool Size	0	集區中允許的連線數目下限。
Pooling	'true'	當 或 yes時true，OracleConnection物件會從適當的集區繪製，或視需要建立並新增至適當的集區。 可辨識的值為 true、false、yes 和 no。

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