ConnectionString屬性「建議收藏」

來源：互聯網轉載時間：2024-01-29 07:54:47

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;Initial Catalog=Northwind;server=(local)"

使用新的 SqlConnectionStringBuilder 在運行時構造有效的連接字符串。有關更多信息,請參見 Building Connection Strings。

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

若要連接到本地計算機,請將服務器指定為“(本地)”。(必須始終指定一個服務器。)

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

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

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

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

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

復制

"key==word=value"

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

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

關鍵字不區分大小寫。

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

關鍵字	默認值	說明
Application Name	N/A	應用程序的名稱,或者“.Net SqlClient Data Provider”(如果不提供應用程序名稱)。
Asynch	‘false’	如果設置為 true,則啟用異步操作支持?？勺R別的值為 true、false、yes 和 no。
AttachDBFilename – 或 – extended properties – 或 – Initial File Name	N/A	主數據庫文件的名稱,包括可連接數據庫的完整路徑名。該路經可以是絕對路徑,也可以是相對路徑,這取決于是否使用 DataDirectory 替換字符串。如果使用 DataDirectory,則對應的數據庫文件必須存在于替換字符串指向的目錄的子目錄中。遠程服務器、HTTP 及 UNC 路徑名不受支持。必須按照如下方式使用關鍵字“database”(或其別名之一)指定數據庫名稱: "AttachDbFileName=\|DataDirectory\|dataYourDB.mdf;integrated security=true;database=YourDatabase"	遠程服務器、HTTP 及 UNC 路徑名不受支持。
遠程服務器、HTTP 及 UNC 路徑名不受支持。
Connect Timeout – 或 – Connection Timeout	15	在終止嘗試并產生錯誤之前,等待與服務器的連接的時間長度(以秒為單位)。
Context Connection	‘false’	如果應對 SQL Server 進行進程內連接,則為 true。
Current Language	N/A	SQL Server 語言記錄名稱。
Data Source – 或 – Server – 或 – Address – 或 – Addr – 或 – Network Address	N/A	要連接的 SQL Server 實例的名稱或網絡地址?？梢栽诜掌髅Q之后指定端口號: server=tcp:servername, portnumber 指定本地實例時,始終使用 (local)。若要強制使用某個協議,請添加下列前綴之一: np:(local), tcp:(local), lpc:(local)
Encrypt	‘false’	當該值為 true 時,如果服務器端安裝了證書,則 SQL Server 將對所有在客戶端和服務器之間傳送的數據使用 SSL 加密?？勺R別的值為 true、false、yes 和 no。
Enlist	‘false’	true 表明 SQL Server 連接池程序在創建線程的當前事務上下文中自動登記連接。
Failover Partner	N/A	在其中配置數據庫鏡像的故障轉移合作伙伴服務器的名稱。.NET Framework 1.0 或 1.1 版不支持 Failover Partner 關鍵字。
Initial Catalog – 或 – Database	N/A	數據庫的名稱。
Integrated Security – 或 – Trusted_Connection	‘false’	當為 false 時,將在連接中指定用戶 ID 和密碼。當為 true 時,將使用當前的 Windows 帳戶憑據進行身份驗證?？勺R別的值為 true、false、yes、no 以及與 true 等效的 sspi(強烈推薦)。
MultipleActiveResultSets	‘true’	如果為 true,則應用程序可以維護多活動結果集 (MARS)。如果為 false,則應用程序必須在執行該連接上的任何其他批處理之前處理或取消一個批處理中的多個結果集?？勺R別的值為 true 和 false。.NET Framework 1.0 或 1.1 版不支持該關鍵字。
Network Library – 或 – Net	‘dbmssocn’	用于建立與 SQL Server 實例的連接的網絡庫。支持的值包括 dbnmpntw(命名管道)、dbmsrpcn(多協議)、dbmsadsn (Apple Talk)、dbmsgnet (VIA)、dbmslpcn(共享內存)及 dbmsspxn (IPX/SPX) 和 dbmssocn (TCP/IP)。相應的網絡 DLL 必須安裝在要連接的系統上。如果不指定網絡而使用一個本地服務器(比如“.”或“(local)”),則使用共享內存。
Packet Size	8192	用來與 SQL Server 的實例進行通信的網絡數據包的大小,以字節為單位。
Password – 或 – Pwd	N/A	SQL Server 帳戶登錄的密碼。建議不要使用。為保持高安全級別,我們強烈建議您使用 Integrated Security 或 Trusted_Connection 關鍵字。
Persist Security Info	‘false’	當該值設置為 false 或 no(強烈推薦)時,如果連接是打開的或者一直處于打開狀態,那么安全敏感信息(如密碼)將不會作為連接的一部分返回。重置連接字符串將重置包括密碼在內的所有連接字符串值?？勺R別的值為 true、false、yes 和 no。
Replication	‘false’	如果使用連接來支持復制,則為 true。
TrustServerCertificate	‘false’	如果設置為 true,則使用 SSL 對通道進行加密,但不通過證書鏈對可信度進行驗證。如果將 TrustServerCertificate 設置為 true 并將 Encrypt 設置為 false,則不對通道進行加密?？勺R別的值為 true、false、yes 和 no。有關更多信息,請參見 SQL Server 2005 Books Online(《SQL Server 2005 聯機叢書》)中的“Encryption Hierarchy”(加密層次結構)和“Using Encryption Without Validation”(使用不驗證的加密)。
Type System Version	N/A	指示應用程序期望的類型系統的字符串值?？赡艿闹涤? Type System Version=SQL Server 2000; Type System Version=SQL Server 2005; Type System Version=Latest; 如果設置為 SQL Server 2000,將使用 SQL Server 2000 類型系統。與 SQL Server 2005 實例連接時,執行下列轉換:XML 到 NTEXTUDT 到 VARBINARYVARCHAR(MAX)、NVARCHAR(MAX) 和 VARBINARY(MAX) 分別到 TEXT、NEXT 和 IMAGE。如果設置為 SQL Server 2005,將使用 SQL Server 2005 類型系統。對 ADO.NET 的當前版本不進行任何轉換。如果設置為 Latest,將使用此客戶端-服務器對無法處理的最新版本。這個最新版本將隨著客戶端和服務器組件的升級自動更新。
User ID	N/A	SQL Server 登錄帳戶。建議不要使用。為保持高安全級別,我們強烈建議您使用 Integrated Security 或 Trusted_Connection 關鍵字。
User Instance	‘false’	一個值,用于指示是否將連接從默認的 SQL Server 速成版實例重定向到調用方帳戶下運行的運行時啟動的實例。
Workstation ID	本地計算機名稱	連接到 SQL Server 的工作站的名稱。

下表列出了 ConnectionString 內連接池值的有效名稱。有關更多信息,請參見使用連接池。

名稱	默認值	說明
Connection Lifetime	0	當連接被返回到池時,將其創建時間與當前時間作比較,如果時間長度(以秒為單位)超出了由 Connection Lifetime 指定的值,該連接就會被銷毀。這在聚集配置中很有用(用于強制執行運行中的服務器和剛置于聯機狀態的服務器之間的負載平衡)。零 (0) 值將使池連接具有最大的連接超時。
Connection Reset	‘true’	確定從池中提取數據庫連接時是否重置數據庫連接。對于 SQL Server 7.0 版,設置為 false 可避免獲取連接時再有一次額外的服務器往返行程,但須注意此時并未重置連接狀態(如數據庫上下文)。只要不將 Connection Reset 設置為 false,連接池程序就不會受到 ChangeDatabase 方法的影響。連接在退出相應的連接池以后將被重置,并且服務器將移回登錄時數據庫。不會創建新的連接,也不會重新進行身份驗證。如果將 Connection Reset 設置為 false,則池中可能會產生不同數據庫的連接。
Enlist	‘true’	當該值為 true 時,池程序在創建線程的當前事務上下文中自動登記連接?？勺R別的值為 true、false、yes 和 no。
Load Balance Timeout	0	連接被銷毀前在連接池中生存的最短時間(以秒為單位)。
Max Pool Size	100	池中允許的最大連接數。
Min Pool Size	0	池中允許的最小連接數。
Pooling	‘true’	當該值為 true 時,系統將從適當的池中提取 SQLConnection 對象,或在需要時創建該對象并將其添加到適當的池中?？勺R別的值為 true、false、yes 和 no。

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

158057.html

本文由 貴州做網站公司 整理發布，部分圖文來源于互聯網，如有侵權，請聯系我們刪除，謝謝！

標簽：connectionstring-

上一篇：Java Java.io.File.createTempFile實例講解

下一篇：exit函數