SqlConnection.ConnectionString 屬性

ConnectionString 類似于 OLE DB 連接字符串，但并不相同。與 OLE DB 或 ADO 不同，如果“Persist Security Info ”值設置為 false（默認值），則返回的連接字符串與用戶設置的 ConnectionString 相同但去除了安全信息。除非將“Persist Security Info ”設置為 true，否則，SQL Server .NET Framework 數據提供程序將不會保持，也不會返回連接字符串中的密碼。

可以使用 ConnectionString 屬性連接到數據庫。下面的示例闡釋了一個典型的連接字符串。

"Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer"

只有在連接關閉時才能設置 ConnectionString 屬性。許多連接字符串值都具有相應的只讀屬性。當設置連接字符串時，將更新所有這些屬性（除非檢測到錯誤）。檢測到錯誤時，不會更新任何屬性。SqlConnection 屬性只返回那些包含在 ConnectionString 中的設置。

若要連接到本地機器，請將服務器指定為“(local)”。（必須始終指定一個服務器。）

重置已關閉連接上的 ConnectionString 會重置包括密碼在內的所有連接字符串值（和相關屬性）。例如，如果設置一個連接字符串，其中包含“Database= northwind”，然后再將該連接字符串重置為“Data Source=myserver;Integrated Security=SSPI”，則 Database 屬性將不再設置為 Northwind。

在設置后會立即分析連接字符串。如果在分析時發現語法中有錯誤，則產生運行庫異常，如 ArgumentException。只有當試圖打開連接時，才會發現其他錯誤。

連接字符串的基本格式包括一系列由分號分隔的關鍵字/值對。等號 (=) 連接各個關鍵字及其值。若要包括含有分號、單引號字符或雙引號字符的值，則該值必須用雙引號括起來。如果該值同時包含分號和雙引號字符，則該值可以用單引號括起來。如果該值以雙引號字符開始，則還可以使用單引號。相反地，如果該值以單引號開始，則可以使用雙引號。如果該值同時包含單引號和雙引號字符，則用于將值括起來的引號字符每次出現時，都必須成對出現。

若要在字符串值中包括前導或尾隨空格，則該值必須用單引號或雙引號括起來。即使將整數、布爾值或枚舉值用引號括起來，其周圍的任何前導或尾隨空格也將被忽略。然而，保留字符串關鍵字或值內的空格。使用 .NET Framework 1.1 版時，在連接字符串中可以使用單引號或雙引號而不用使用分隔符（例如，Data Source= my'Server 或 Data Source= my"Server），但引號字符不可以為值的第一個或最后一個字符。

若要在關鍵字或值中包括等號 (=)，則它之前必須還有另一個等號。例如，在假設的連接字符串中，

"key==word=value"

關鍵字是“key=word”并且值是“value”。

如果“keyword= value”對中的一個特定關鍵字多次出現在連接字符串中，則將所列出的最后一個用于值集。

關鍵字不區分大小寫。

下表列出了 ConnectionString 中的關鍵字值的有效名稱。

下表列出了 ConnectionString 內連接池值的有效名稱。有關連接池的更多信息，請參見 SQL Server .NET Framework 數據提供程序連接池。

當設置需要布爾值的關鍵字或連接池值時，您可以使用 'yes' 代替 'true'，'no' 代替 'false'。整數值表示為字符串。

注意   SQL Server .NET Framework 數據提供程序使用它自己的協議與 SQL Server 進行通信。因此，當連接到 SQL Server 時，它不支持 ODBC 數據源名稱 (DSN) 的使用，因為它不添加 ODBC 層。 警告   在此版本中，在應用程序中根據用戶輸入構造連接字符串時（例如，從對話框中檢索用戶 ID 和密碼信息并將其追加到連接字符串時）應相當謹慎。應用程序應確保用戶無法在這些值中嵌入額外的連接字符串參數（例如，輸入“validpassword;database=somedb”作為密碼，以試圖連接到其他數據庫）。

示例

[Visual Basic, C#] 下面的示例創建一個 SqlConnection并設置它的一些屬性。

[Visual Basic] 
Public Sub CreateSqlConnection()
    Dim myConnection As New SqlConnection()
    myConnection.ConnectionString = 
"Persist Security Info=False;Integrated Security=SSPI;
database=northwind;server=mySQLServer;Connect Timeout=30"
    myConnection.Open()
End Sub 'CreateSqlConnection

[C#] 
public void CreateSqlConnection() 
 {
    SqlConnection myConnection = new SqlConnection();
    myConnection.ConnectionString = 
"Persist Security Info=False;Integrated Security=SSPI;
database=northwind;server=mySQLServer;Connect Timeout=30";
    myConnection.Open();
 }