SqlColumnEncryptionKeyStoreProvider.EncryptColumnEncryptionKeyAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verschlüsselt asynchron einen Spaltenverschlüsselungsschlüssel mithilfe des Spaltenmasterschlüssels mit dem angegebenen Schlüsselpfad und dem angegebenen Algorithmus.
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
Der Spaltenmasterschlüsselpfad. Das Pfadformat ist spezifisch für die Implementierung des Schlüsselspeicheranbieters (z. B. ein Fingerabdruck für den Zertifikatspeicher oder eine Schlüssel-ID-URL für Azure Key Vault).
- encryptionAlgorithm
- String
Der Name des Verschlüsselungsalgorithmus. Beispiel: RSA_OAEP
- columnEncryptionKey
- Byte[]
Der zu verschlüsselnde Spaltenverschlüsselungsschlüssel.
- cancellationToken
- CancellationToken
Ein Token zum Abbrechen des asynchronen Vorgangs.
Gibt zurück
Eine Aufgabe, die ein Byte Array zurückgibt, das den verschlüsselten Spaltenverschlüsselungsschlüssel nach Abschluss darstellt.
Hinweise
Die Standardimplementierung überprüft zuerst die cancellationToken und gibt eine abgebrochene Aufgabe zurück, wenn eine Abbruchanforderung angefordert wurde. Andernfalls ruft sie die synchrone EncryptColumnEncryptionKey(String, String, Byte[]) Methode auf und umschließt das Ergebnis in einer abgeschlossenen Aufgabe. Wenn die synchrone Methode ausgelöst wird, wird die Ausnahme abgefangen, und eine fehlerhafte Aufgabe wird zurückgegeben, anstatt synchron zu werfen.
Abgeleitete Klassen, die E/A ausführen (z. B. Aufrufe an Azure Key Vault), sollten diese Methode mit einer wirklich asynchronen Implementierung überschreiben, die das Abbruchtoken berücksichtigt.