SqlColumnEncryptionKeyStoreProvider.DecryptColumnEncryptionKeyAsync Metode

Definisi

Ruang nama:: Microsoft.Data.SqlClient

Rakitan:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v7.1.0

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Secara asinkron mendekripsi nilai terenkripsi yang ditentukan dari kunci enkripsi kolom. Nilai terenkripsi diharapkan dienkripsi menggunakan kunci master kolom dengan jalur kunci yang ditentukan dan menggunakan algoritma yang ditentukan.

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

Parameter

masterKeyPath: String

Jalur kunci master kolom. Format jalur khusus untuk implementasi penyedia penyimpanan kunci (misalnya thumbprint untuk penyimpanan sertifikat, atau URL pengidentifikasi kunci untuk Azure Key Vault).

encryptionAlgorithm: String

Nama algoritma enkripsi. Contohnya, RSA_OAEP.

encryptedColumnEncryptionKey: Byte[]

Kunci enkripsi kolom terenkripsi.

cancellationToken: CancellationToken

Token untuk membatalkan operasi asinkron.

Mengembalikan

Task<Byte[]>

Tugas yang mengembalikan array yang Byte mewakili kunci enkripsi kolom yang didekripsi saat selesai.

Keterangan

Implementasi default pertama-tama cancellationToken memeriksa dan mengembalikan tugas yang dibatalkan jika pembatalan telah diminta. Jika tidak, ini memanggil metode sinkron DecryptColumnEncryptionKey(String, String, Byte[]) dan membungkus hasil dalam tugas yang diselesaikan. Jika metode sinkron dilemparkan, pengecualian tertangkap dan tugas yang rusak dikembalikan daripada dilemparkan secara sinkron.

Kelas turunan yang melakukan I/O (seperti panggilan ke Azure Key Vault) harus mengambil alih metode ini dengan implementasi yang benar-benar asinkron yang menghormati token pembatalan.

Berlaku untuk