SqlColumnEncryptionKeyStoreProvider.EncryptColumnEncryptionKeyAsync 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.

Mengenkripsi kunci enkripsi kolom secara asinkron menggunakan kunci master kolom dengan jalur kunci yang ditentukan dan menggunakan algoritma yang ditentukan.

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

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

Public Overridable Function EncryptColumnEncryptionKeyAsync (masterKeyPath As String, encryptionAlgorithm As String, columnEncryptionKey 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.

columnEncryptionKey: Byte[]

Kunci enkripsi kolom untuk dienkripsi.

cancellationToken: CancellationToken

Token untuk membatalkan operasi asinkron.

Mengembalikan

Task<Byte[]>

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

Keterangan

Implementasi default pertama-tama cancellationToken memeriksa dan mengembalikan tugas yang dibatalkan jika pembatalan telah diminta. Jika tidak, ini memanggil metode sinkron EncryptColumnEncryptionKey(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