SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection Метод

  • Ссылка

Определение

Пространство имен:
Microsoft.Data.SqlClient
Сборка:
Microsoft.Data.SqlClient.dll
Пакет:
Microsoft.Data.SqlClient v3.0.1
Пакет:
Microsoft.Data.SqlClient v3.1.0
Пакет:
Microsoft.Data.SqlClient v4.0.1
Пакет:
Microsoft.Data.SqlClient v4.1.0
Пакет:
Microsoft.Data.SqlClient v5.0.0
Пакет:
Microsoft.Data.SqlClient v5.1.0
Пакет:
Microsoft.Data.SqlClient v5.2.0

Регистрирует поставщиков хранилища ключей шифрования в экземпляре SqlConnection . Если эта функция была вызвана, все поставщики, зарегистрированные с помощью статических RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) методов, будут игнорироваться. Эту функцию можно вызывать несколько раз. Это выполняет неглубокое копирование словаря, чтобы приложение не могло изменить настраиваемый список поставщиков после его настройки.

public:
 void RegisterColumnEncryptionKeyStoreProvidersOnConnection(System::Collections::Generic::IDictionary<System::String ^, Microsoft::Data::SqlClient::SqlColumnEncryptionKeyStoreProvider ^> ^ customProviders);
public void RegisterColumnEncryptionKeyStoreProvidersOnConnection (System.Collections.Generic.IDictionary<string,Microsoft.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider> customProviders);
member this.RegisterColumnEncryptionKeyStoreProvidersOnConnection : System.Collections.Generic.IDictionary<string, Microsoft.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider> -> unit
Public Sub RegisterColumnEncryptionKeyStoreProvidersOnConnection (customProviders As IDictionary(Of String, SqlColumnEncryptionKeyStoreProvider))

Параметры

customProviders
IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Словарь настраиваемых поставщиков ключей шифрования столбцов

Исключения

ArgumentNullException

Предоставлен словарь null.

-или-

Строковый ключ в словаре имеет значение NULL или пустой.

-или-

Значение SqlColumnEncryptionKeyStoreProvider в словаре равно NULL.

ArgumentException

Строковый ключ в словаре начинается с "MSSQL_". Этот префикс зарезервирован для системных поставщиков.

Комментарии

Пользовательские поставщики хранилища главных ключей можно регистрировать в драйвере на трех разных уровнях. Ниже описывается, в какой очередности применяются эти три уровня регистрации.

  • Сначала проверяется, имеется ли регистрация на уровне команды.
  • Если она отсутствует, проверяется наличие регистрации на уровне подключения.
  • Если регистрация на уровне подключения отсутствует, проверяется глобальная регистрация.

После нахождения поставщика хранилища ключей на определенном уровне регистрации драйвер НЕ обращается к другим уровням для поиска поставщика. Если поставщики зарегистрированы, но соответствующий поставщик не найден на данном уровне, создается исключение, в котором указываются только зарегистрированные поставщики на проверенном уровне регистрации.

Встроенные поставщики хранилища главных ключей для столбцов, доступные для хранилища сертификатов Windows, хранилища CNG и CSP, зарегистрированы изначально.

Это выполняет неглубокое копирование словаря, чтобы приложение не могло изменить настраиваемый список поставщиков после его настройки.

Применяется к