SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.