OracleConnection.ConnectionString 屬性

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 連接字串，包含建立初始連接所需要的設定，例如伺服器名稱。 預設值為空字串 ("")。

實作

屬性

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值的有效名稱。

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

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

適用於