SqlColumnEncryptionKeyStoreProvider.DecryptColumnEncryptionKeyAsync Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Package:

Microsoft.Data.SqlClient v7.1.0

Déchiffre de façon asynchrone la valeur chiffrée spécifiée d’une clé de chiffrement de colonne. La valeur chiffrée est censée être chiffrée à l’aide de la clé principale de colonne avec le chemin de clé spécifié et à l’aide de l’algorithme spécifié.

public virtual System.Threading.Tasks.Task<byte[]> DecryptColumnEncryptionKeyAsync(string masterKeyPath, string encryptionAlgorithm, byte[] encryptedColumnEncryptionKey, System.Threading.CancellationToken cancellationToken = default);

abstract member DecryptColumnEncryptionKeyAsync : string * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
override this.DecryptColumnEncryptionKeyAsync : string * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>

Public Overridable Function DecryptColumnEncryptionKeyAsync (masterKeyPath As String, encryptionAlgorithm As String, encryptedColumnEncryptionKey As Byte(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Byte())

Paramètres

masterKeyPath

String

Chemin de la clé principale de colonne. Le format de chemin est spécifique à l’implémentation du fournisseur de magasin de clés (par exemple, une empreinte numérique pour le magasin de certificats ou une URL d’identificateur de clé pour Azure Key Vault).

encryptionAlgorithm

String

Nom de l’algorithme de chiffrement. Par exemple : RSA_OAEP.

encryptedColumnEncryptionKey

Byte[]

Clé de chiffrement de colonne chiffrée.

cancellationToken

CancellationToken

Jeton pour annuler l’opération asynchrone.

Retours

Task<Byte[]>

Tâche qui retourne un Byte tableau représentant la clé de chiffrement de colonne déchiffrée à l’achèvement.

Remarques

L’implémentation par défaut vérifie d’abord la cancellationToken tâche annulée et retourne une tâche annulée si l’annulation a été demandée. Sinon, il appelle la méthode synchrone DecryptColumnEncryptionKey(String, String, Byte[]) et encapsule le résultat dans une tâche terminée. Si la méthode synchrone lève, l’exception est interceptée et une tâche défectueuse est retournée plutôt que de lever de façon synchrone.

Les classes dérivées qui effectuent des E/S (telles que les appels à Azure Key Vault) doivent remplacer cette méthode par une implémentation véritablement asynchrone qui respecte le jeton d’annulation.