SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Inscrit les fournisseurs de magasins de clés de chiffrement sur l’instance SqlCommand . Si cette fonction a été appelée, tous les fournisseurs inscrits à l’aide des RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) méthodes ou RegisterColumnEncryptionKeyStoreProvidersOnConnection(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) sont ignorés. Cette fonction peut être appelée plusieurs fois. Cette opération effectue une copie superficielle du dictionnaire afin que l’application ne puisse pas modifier la liste des fournisseurs personnalisés une fois qu’elle a été définie.

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

Paramètres

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Dictionnaire de fournisseurs de clés de chiffrement de colonne personnalisés

Exceptions

ArgumentNullException

Un dictionnaire null a été fourni.

-ou-

Une clé de chaîne dans le dictionnaire était null ou vide.

-ou-

Une SqlColumnEncryptionKeyStoreProvider valeur dans le dictionnaire était null.

ArgumentException

Une clé de chaîne dans le dictionnaire a commencé par « MSSQL_ ». Ce préfixe est réservé aux fournisseurs système.

Remarques

Les fournisseurs de magasins de clés principales personnalisés peuvent être inscrits auprès du pilote dans trois couches différentes. La priorité des trois inscriptions est la suivante :

• L’inscription par commande est vérifiée si elle n’est pas vide.
• Si l’inscription par commande est vide, l’inscription par connexion est vérifiée si elle n’est pas vide.
• Si l’inscription par connexion est vide, l’inscription globale est vérifiée.

Une fois qu’un fournisseur de magasin de clés est trouvé au niveau d’une inscription, le pilote ne revient PAS aux autres inscriptions pour rechercher un fournisseur. Si des fournisseurs sont inscrits, mais que le fournisseur approprié est introuvable à un niveau, une exception est levée, contenant uniquement les fournisseurs inscrits dans l’inscription qui a été vérifiée.

Les fournisseurs de magasins de clés principales de colonne intégrés qui sont disponibles pour le magasin de certificats Windows, le magasin CNG et CSP sont préinscrits.

Cette opération effectue une copie superficielle du dictionnaire afin que l’application ne puisse pas modifier la liste des fournisseurs personnalisés une fois qu’elle a été définie.