LocalDB 的 SqlClient 支援

用 Microsoft.Data.SqlClient NuGet 套件用來連接 LocalDB,這是 Windows 上可用的輕量級 SQL Server。 本文範例中請使用 Windows 整合認證。

備註

若要摘要說明您可以使用 LocalDB 執行的動作:

  • 使用 SqlLocalDB.exe 建立並啟動 LocalDB 實例。

  • 使用 sqlcmd.exe 在 LocalDB 實例中新增和修改資料庫。 例如: sqlcmd -S (localdb)\myinst 。

  • AttachDBFilename使用連接字串關鍵詞,將資料庫新增至LocalDB實例。 使用 AttachDBFilename時,如果您未使用 Database 連接字串關鍵詞指定資料庫的名稱,當應用程式關閉時,資料庫將會從LocalDB實例中移除。

  • 在您的連接字串中指定 LocalDB 實例。 例如,您的實體名稱是 myInstance,連接字串會包含:

    Server=(localdb)\myInstance;Database=<database>;Integrated Security=true;Encrypt=true

User Instance=True 連接到 LocalDB 資料庫時不允許。

如需安裝 LocalDB 的相關信息,請參閱 SQL Server Express LocalDB。

以程序設計方式建立具名實例

現代 .NET 上的 Microsoft.Data.SqlClient 不使用 .NET Framework system.data.localdb 設定區段。 在應用程式開啟連線前,先建立並啟動實例:

SqlLocalDB.exe create myInstance
SqlLocalDB.exe start myInstance

在 Server connection-string 關鍵字中指定相同的實例名稱。 若要附加現有的資料庫檔案,請將 AttachDBFilename 設為該檔案的完整路徑,並將 Database 設為資料庫名稱。

若是本地開發且沒有受信任伺服器憑證的 LocalDB 實例,請使用 Encrypt=true;TrustServerCertificate=true。 此設定會加密連線,但跳過伺服器憑證驗證。 對於遠端生產連線,使用 Encrypt=true;TrustServerCertificate=false 並設定一個客戶端信任且與伺服器名稱相符的伺服器憑證。 如需詳細資訊,請參閱 Microsoft.Data.SqlClient中的加密和憑證驗證。

另請參閱