SqlColumnEncryptionKeyStoreProvider.DecryptColumnEncryptionKeyAsync Metodo

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v7.1.0

Decrittografa in modo asincrono il valore crittografato specificato di una chiave di crittografia della colonna. Il valore crittografato deve essere crittografato usando la chiave master della colonna con il percorso della chiave specificato e usando l'algoritmo specificato.

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

Parametri

masterKeyPath

String

Percorso della chiave master della colonna. Il formato del percorso è specifico per l'implementazione del provider dell'archivio chiavi, ad esempio un'identificazione personale per l'archivio certificati o un URL dell'identificatore di chiave per Azure Key Vault.

encryptionAlgorithm

String

Nome dell'algoritmo di crittografia. Ad esempio: RSA_OAEP.

encryptedColumnEncryptionKey

Byte[]

Chiave di crittografia della colonna crittografata.

cancellationToken

CancellationToken

Token per annullare l'operazione asincrona.

Valori restituiti

Task<Byte[]>

Attività che restituisce una Byte matrice che rappresenta la chiave di crittografia della colonna decrittografata al completamento.

Commenti

L'implementazione predefinita controlla innanzitutto e restituisce un'attività cancellationToken annullata se è stato richiesto l'annullamento. In caso contrario, chiama il metodo sincrono DecryptColumnEncryptionKey(String, String, Byte[]) ed esegue il wrapping del risultato in un'attività completata. Se il metodo sincrono genera, l'eccezione viene intercettata e viene restituita un'attività con errori anziché generare in modo sincrono.

Le classi derivate che eseguono operazioni di I/O (ad esempio le chiamate a Azure Key Vault) devono eseguire l'override di questo metodo con un'implementazione veramente asincrona che rispetta il token di annullamento.