System.Data.SqlClient 命名空間

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

System.Data.SqlClient 命名空間是 .NET Data Provider for SQL Server。

Important

新開發的話，請使用 Microsoft。Data.SqlClient。此命名空間記錄了現有應用程式的舊有提供者及需要該服務的 .NET Framework 特定情境。

類別

名稱	Description
SqlAuthenticationInitializer	定義可登錄於 app.config 檔案的認證初始化器核心行為，並提供衍生類別的基礎。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlAuthenticationParameters	代表由驅動程式傳遞給認證提供者的 AD 認證參數。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlAuthenticationProvider	定義認證提供者的核心行為，並提供衍生類別的基底類別。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlAuthenticationToken	代表 AD 認證憑證。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlBulkCopy	這樣可以有效地大量載入 SQL Server 資料表，從其他來源取得資料。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlBulkCopyColumnMapping	定義實例資料來源欄位 SqlBulkCopy 與目標資料表欄位之間的映射。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlBulkCopyColumnMappingCollection	繼承自 SqlBulkCopyColumnMapping的物件集合CollectionBase。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlClientFactory	代表一組用於建立 System.Data.SqlClient 提供者實作資料來源類別實例的方法。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlClientLogger	代表 SQL 用戶端記錄器。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlClientMetaDataCollectionNames	提供一個常數清單，供 GetSchema 方法用來擷取元資料集合。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlClientPermission	啟用 SQL Server 的 .NET Framework 資料提供者，協助確保使用者擁有足夠的安全等級以存取資料來源。此 API 支援 .NET Framework 程式碼存取安全性。新資料庫開發建議使用 Microsoft。Data.SqlClient;保留此 API，適用於需要 .NET Framework 程式碼存取安全的應用程式。
SqlClientPermissionAttribute	將安全動作與自訂的安全屬性關聯起來。此 API 支援 .NET Framework 程式碼存取安全性。新資料庫開發建議使用 Microsoft。Data.SqlClient;保留此 API，適用於需要 .NET Framework 程式碼存取安全的應用程式。
SqlColumnEncryptionCertificateStoreProvider	Windows 憑證儲存庫金鑰儲存提供者的實作。此類別允許將儲存在 Windows 憑證儲存庫中的憑證作為欄位主鍵使用。詳情請參見「始終加密」。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlColumnEncryptionCngProvider	CMK Store 提供者實作，用於使用 Microsoft 密碼學 API：下一代（CNG） Always Encrypted。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlColumnEncryptionCspProvider	CMK Store 提供者實作，用於使用 Microsoft CAPI 基礎的加密服務提供者（CSP），Always Encrypted。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlColumnEncryptionEnclaveProvider	定義 Always Encrypted 的 enclave 提供者介面的基底類別。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlColumnEncryptionKeyStoreProvider	所有金鑰存放區提供者的基底類別。自訂提供者必須從此類別衍生並覆寫其成員函式，然後使用 SqlConnection.RegisterColumnEncryptionKeyStoreProviders（）。詳情請參見「永遠加密」。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlCommand	代表一個 Transact-SQL 陳述式或儲存程序，用於對 SQL Server 資料庫執行。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlCommandBuilder	自動產生單表指令，用於將對 DataSet 的變更與相關 SQL Server 資料庫進行調和。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlConnection	代表與 SQL Server 資料庫的連線。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlConnectionStringBuilder	提供簡單的方法來建立和管理 SqlConnection 類別所使用的連接字串內容。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlCredential	SqlCredential 提供了一種更安全的登入方式，使用SQL Server驗證來指定密碼。 SqlCredential 由一個使用者 ID 和一個用於SQL Server驗證的密碼組成。物件中的 SqlCredential 密碼型別為 SecureString。 SqlCredential 無法遺傳。 Windows 認證（`Integrated Security = true`）仍是登入SQL Server資料庫最安全的方式。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlDataAdapter	代表一組資料指令及資料庫連線，用於填入 DataSet 並更新 SQL Server 資料庫。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlDataReader	提供一種從 SQL Server 資料庫讀取僅向前列資料流的方法。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SQLDebugging	內建以支援除錯應用程式。並非直接使用。此 API 支援舊有的 .NET Framework 除錯，並非直接使用。新資料庫開發建議使用 Microsoft。Data.SqlClient。
SqlDependency	SqlDependency 物件代表應用程式與 SQL Server 實例之間的查詢通知依賴關係。應用程式可以建立 SqlDependency 物件並註冊以透過事件處理程序接收通知 OnChangeEventHandler 。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlEnclaveAttestationParameters	封裝 SqlClient 傳送至 SQL Server 以啟動與 enclave 建立安全會話的驗證流程，SQL Server 用於對 Always Encrypted 保護欄位的計算。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlEnclaveSession	封裝 SqlClient 與 SQL Server 內隔區之間安全會話的狀態，可用於對受 Always Encrypted 保護的加密欄位進行計算。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlError	收集與 SQL Server 回傳的警告或錯誤相關的資訊。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlErrorCollection	收集 .NET Framework Data Provider for SQL Server 所產生的所有錯誤。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlException	當 SQL Server 回傳警告或錯誤時拋出的例外。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlInfoMessageEventArgs	提供 InfoMessage 事件的資料。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlNotificationEventArgs	代表傳遞給通知事件處理程序的參數集合。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlParameter	代表一個參數到 a SqlCommand ，並可選擇地將其映射到 DataSet 欄位。此類別無法獲得繼承。欲了解更多參數資訊，請參閱「參數配置與參數資料型別」。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlParameterCollection	代表一組與相關 SqlCommand 聯的參數及其對 DataSet應到欄位的映射。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlProviderServices	這是 SQL Server SqlClient 提供者的 DbProviderServices 實作。保留此 API 用於內建的 .NET Framework 實體框架提供者。關於新的資料庫開發，請參見 Microsoft。Data.SqlClient。
SqlRowsCopiedEventArgs	代表傳遞給的 SqlRowsCopiedEventHandler參數集合。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlRowUpdatedEventArgs	提供 RowUpdated 事件的資料。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlRowUpdatingEventArgs	提供 RowUpdating 事件的資料。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlTransaction	代表一個在 SQL Server 資料庫中進行的 Transact-SQL 交易。此類別無法獲得繼承。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。

列舉

名稱	Description
ApplicationIntent	指定 ApplicationIntent的值。可能的值是 `ReadWrite` 和 `ReadOnly`。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
PoolBlockingPeriod	指定 PoolBlockingPeriod 屬性的值。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SortOrder	指定數據列的排序方式。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlAuthenticationMethod	描述連接 Azure SQL Database 的用戶端可使用的各種 SQL 認證方法。詳情請參見使用 Azure Active Directory 認證連接 SQL 資料庫。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlBulkCopyOptions	指定一或多個選項搭配實體使用的位旗標，SqlBulkCopy。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlCommandColumnEncryptionSetting	指定讀取和寫入加密數據行時，數據的傳送和接收方式。視您的特定查詢而定，使用非加密數據行時略過 Always Encrypted 驅動程序的處理，可能會降低效能影響。請注意，這些設定無法用來略過加密並存取純文本數據。詳情請參見 Always Encrypted （資料庫引擎）。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlConnectionColumnEncryptionSetting	指定在連線中啟用 Always Encrypted 功能。請注意，這些設定無法用來略過加密並存取純文本數據。詳情請參見 Always Encrypted （資料庫引擎）。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlNotificationInfo	此列舉提供相依性事件處理程式可接收之不同通知的其他資訊。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlNotificationSource	指出相依性事件處理程式所接收通知的來源。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlNotificationType	描述可透過 OnChangeEventHandler 參數由 SqlNotificationEventArgs 事件處理程式接收的不同通知類型。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。

委派

名稱	Description
OnChangeEventHandler	處理 OnChange 當收到與物件相關 SqlDependency 指令的通知時所觸發的事件。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlInfoMessageEventHandler	代表將處理InfoMessage SqlConnection事件的方法。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlRowsCopiedEventHandler	代表處理 SqlRowsCopied 事件 SqlBulkCopy的方法。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlRowUpdatedEventHandler	代表將處理RowUpdated SqlDataAdapter事件的方法。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。
SqlRowUpdatingEventHandler	代表將處理RowUpdating SqlDataAdapter事件的方法。新開發的話，請使用 Microsoft。Data.SqlClient。本頁說明了 System.Data.SqlClient。

備註

Note

這些 System.Data.SqlClient API 已經被棄用。新開發時，請使用 Microsoft.Data.SqlClient API。

SQL Server 的.NET Data Provider描述了一組用於存取管理空間中SQL Server資料庫的類別。利用， SqlDataAdapter你可以填入一個駐留 DataSet 記憶體，用來查詢和更新資料庫。

Note

關於在使用 .NET 程式設計時使用此命名空間的概念性資訊，請參見 SQL Server 和 ADO.NET。

意見反應

此頁面對您有幫助嗎？