SqlColumnEncryptionKeyStoreProvider.EncryptColumnEncryptionKeyAsync Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v7.1.0

Asynchronně šifruje šifrovací klíč sloupce pomocí hlavního klíče sloupce se zadanou cestou ke klíči a pomocí zadaného algoritmu.

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

Parametry

masterKeyPath

String

Cesta k hlavnímu klíči sloupce. Formát cesty je specifický pro implementaci zprostředkovatele úložiště klíčů (např. kryptografický otisk úložiště certifikátů nebo adresu URL identifikátoru klíče pro Azure Key Vault).

encryptionAlgorithm

String

Název šifrovacího algoritmu. Například: RSA_OAEP.

columnEncryptionKey

Byte[]

Šifrovací klíč sloupce, který se má šifrovat.

cancellationToken

CancellationToken

Token pro zrušení asynchronní operace.

Návraty

Task<Byte[]>

Úloha, která vrací Byte pole představující šifrovací klíč šifrovaného sloupce po dokončení.

Poznámky

Výchozí implementace nejprve zkontroluje cancellationToken a vrátí zrušený úkol, pokud bylo požadováno zrušení. V opačném případě volá synchronní EncryptColumnEncryptionKey(String, String, Byte[]) metodu a zabalí výsledek do dokončené úlohy. Pokud synchronní metoda vyvolá výjimku, je zachycena a chybný úkol se vrátí místo synchronně vyvolání.

Odvozené třídy, které provádějí vstupně-výstupní operace (například volání Azure Key Vault), by měly tuto metodu přepsat skutečně asynchronní implementací, která respektuje token zrušení.