SqlConnection.RegisterColumnEncryptionKeyStoreProviders 方法

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

註冊資料行加密金鑰存放區提供者。 此函式應該只在應用程式中呼叫一次。 這會對字典進行淺層複製，讓應用程式在設定自訂提供者清單之後無法改變。

預先註冊適用于 Windows 憑證存放區、CNG 存放區和 CSP 的內建資料行主要金鑰存放區提供者。

public:
 static void RegisterColumnEncryptionKeyStoreProviders(System::Collections::Generic::IDictionary<System::String ^, Microsoft::Data::SqlClient::SqlColumnEncryptionKeyStoreProvider ^> ^ customProviders);

public static void RegisterColumnEncryptionKeyStoreProviders (System.Collections.Generic.IDictionary<string,Microsoft.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider> customProviders);

static member RegisterColumnEncryptionKeyStoreProviders : System.Collections.Generic.IDictionary<string, Microsoft.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider> -> unit

Public Shared Sub RegisterColumnEncryptionKeyStoreProviders (customProviders As IDictionary(Of String, SqlColumnEncryptionKeyStoreProvider))

參數

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

自訂資料行加密金鑰存放區提供者的字典

例外狀況

ArgumentNullException

已提供 Null 字典。

-或-

字典中的字串索引鍵為 Null 或空白。

-或-

SqlColumnEncryptionKeyStoreProvider字典中的值為 null。

ArgumentException

字典中的字串索引鍵以 「MSSQL_」 開頭。 此前置詞保留給系統提供者。

InvalidOperationException

此函式已多次呼叫。

範例

 Dictionary<string, SqlColumnEncryptionKeyStoreProvider> customKeyStoreProviders = new Dictionary<string, SqlColumnEncryptionKeyStoreProvider>();
 MySqlClientHSMProvider myProvider = new MySqlClientHSMProvider();
 customKeyStoreProviders.Add(@"HSM Provider", myProvider);
 SqlConnection.RegisterColumnEncryptionKeyStoreProviders(customKeyStoreProviders);