SqlConnection.RegisterColumnEncryptionKeyStoreProviders Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Registriert die Schlüsselspeicheranbieter für die Spaltenverschlüsselung. Diese Funktion sollte nur einmal in einer App aufgerufen werden. Dadurch wird das Wörterbuch flach kopiert, sodass die App die Liste der benutzerdefinierten Anbieter nicht ändern kann, nachdem sie festgelegt wurde.

Die integrierten Anbieter von Speicher für Spaltenhauptschlüssel, die für Windows-Zertifikatspeicher, CNG Store und CSP verfügbar sind, sind bereits vorab registriert.

public:
 static void RegisterColumnEncryptionKeyStoreProviders(System::Collections::Generic::IDictionary<System::String ^, Microsoft::Data::SqlClient::SqlColumnEncryptionKeyStoreProvider ^> ^ customProviders);

public static void RegisterColumnEncryptionKeyStoreProviders (System.Collections.Generic.IDictionary<string,Microsoft.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider> customProviders);

static member RegisterColumnEncryptionKeyStoreProviders : System.Collections.Generic.IDictionary<string, Microsoft.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider> -> unit

Public Shared Sub RegisterColumnEncryptionKeyStoreProviders (customProviders As IDictionary(Of String, SqlColumnEncryptionKeyStoreProvider))

Parameter

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Wörterbuch der Anbieter benutzerdefinierter Spaltenverschlüsselungsschlüssel

Ausnahmen

ArgumentNullException

Ein NULL-Wörterbuch wurde bereitgestellt.

Oder

Ein Zeichenfolgenschlüssel im Wörterbuch war NULL oder leer.

Oder

Ein SqlColumnEncryptionKeyStoreProvider Wert im Wörterbuch war NULL.

ArgumentException

Ein Zeichenfolgenschlüssel im Wörterbuch begann mit "MSSQL_". Dieses Präfix ist Systemanbietern vorbehalten.

InvalidOperationException

Diese Funktion wurde mehrmals aufgerufen.

Beispiele

 Dictionary<string, SqlColumnEncryptionKeyStoreProvider> customKeyStoreProviders = new Dictionary<string, SqlColumnEncryptionKeyStoreProvider>();
 MySqlClientHSMProvider myProvider = new MySqlClientHSMProvider();
 customKeyStoreProviders.Add(@"HSM Provider", myProvider);
 SqlConnection.RegisterColumnEncryptionKeyStoreProviders(customKeyStoreProviders);