SqlColumnEncryptionKeyStoreProvider.EncryptColumnEncryptionKeyAsync Metoda

Definicja

Przestrzeń nazw:: Microsoft.Data.SqlClient

Zestaw:: Microsoft.Data.SqlClient.dll

Pakiet:: Microsoft.Data.SqlClient v7.1.0

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Asynchronicznie szyfruje klucz szyfrowania kolumny przy użyciu klucza głównego kolumny z określoną ścieżką klucza i przy użyciu określonego algorytmu.

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

Ścieżka klucza głównego kolumny. Format ścieżki jest specyficzny dla implementacji dostawcy magazynu kluczy (np. odcisk palca magazynu certyfikatów lub adres URL identyfikatora klucza dla Azure Key Vault).

encryptionAlgorithm: String

Nazwa algorytmu szyfrowania. Na przykład RSA_OAEP.

columnEncryptionKey: Byte[]

Klucz szyfrowania kolumny do zaszyfrowania.

cancellationToken: CancellationToken

Token umożliwiający anulowanie operacji asynchronicznej.

Zwraca

Task<Byte[]>

Zadanie zwracające tablicę reprezentującą Byte zaszyfrowany klucz szyfrowania kolumny po zakończeniu.

Uwagi

Domyślna implementacja najpierw sprawdza cancellationToken i zwraca anulowane zadanie, jeśli zażądano anulowania. W przeciwnym razie wywołuje metodę synchroniczną EncryptColumnEncryptionKey(String, String, Byte[]) i opakowuje wynik w ukończonym zadaniu. Jeśli metoda synchroniczna zgłasza błąd, wyjątek zostanie przechwycony i zostanie zwrócone uszkodzone zadanie zamiast zgłaszać synchronicznie.

Klasy pochodne wykonujące operacje we/wy (takie jak wywołania Azure Key Vault) powinny zastąpić tę metodę prawdziwie asynchroniczną implementacją, która honoruje token anulowania.

Dotyczy