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