Compartir a través de


SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand Método

Definición

Registra los proveedores de almacén de claves de cifrado en la SqlCommand instancia de . Si se ha llamado a esta función, se omitirán los proveedores registrados mediante los RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) métodos o RegisterColumnEncryptionKeyStoreProvidersOnConnection(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) . Se puede llamar a esta función más de una vez. Esto realiza una copia superficial del diccionario para que la aplicación no pueda modificar la lista de proveedores personalizados una vez establecida.

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

Parámetros

customProviders
IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Diccionario de proveedores de claves de cifrado de columnas personalizadas

Excepciones

Se proporcionó un diccionario nulo.

O bien

Una clave de cadena en el diccionario era nula o vacía.

O bien

Un SqlColumnEncryptionKeyStoreProvider valor del diccionario era NULL.

Una clave de cadena del diccionario comenzó con "MSSQL_". Este prefijo está reservado para los proveedores del sistema.

Comentarios

Los proveedores personalizados de almacén de claves maestras se pueden registrar con el controlador en tres capas diferentes. La precedencia de los tres registros es la siguiente:

  • Se comprobará el registro por comando si no está vacío.
  • Si el registro por comando está vacío, se comprobará el registro por conexión si no está vacío.
  • Si el registro por conexión está vacío, se comprobará el registro global.

Una vez que se encuentre un proveedor de almacén de claves en el nivel de registro, el controlador NO volverá a los demás registros para buscar un proveedor. Si los proveedores están registrados, pero no se encuentra el proveedor adecuado en un nivel, se producirá una excepción que contendrá únicamente los proveedores registrados en el registro que se comprobó.

Los proveedores integrados de almacén de claves maestras de columna que están disponibles para el almacén de certificados de Windows, el almacén de CNG y CSP están registrados previamente.

Esto realiza una copia superficial del diccionario para que la aplicación no pueda modificar la lista de proveedores personalizados una vez establecida.

Se aplica a