SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Registra los proveedores de almacén de claves de cifrado en la SqlConnection instancia de . Si se ha llamado a esta función, se omitirán los proveedores registrados mediante los métodos estáticos RegisterColumnEncryptionKeyStoreProviders(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 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))

Parámetros

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Diccionario de proveedores de claves de cifrado de columnas personalizadas

Excepciones

ArgumentNullException

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.

ArgumentException

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.