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);