SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Registriert die Anbieter des Verschlüsselungsschlüsselspeichers in der SqlConnection -Instanz. Wenn diese Funktion aufgerufen wurde, werden alle Anbieter ignoriert, die mit den statischen RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) Methoden registriert wurden. Diese Funktion kann mehrmals aufgerufen werden. Dadurch wird das Wörterbuch flach kopiert, sodass die App die benutzerdefinierte Anbieterliste nach dem Festlegen nicht mehr ändern kann.

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

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

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

Public Sub RegisterColumnEncryptionKeyStoreProvidersOnConnection (customProviders As IDictionary(Of String, SqlColumnEncryptionKeyStoreProvider))

Parameter

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Wörterbuch der Anbieter von benutzerdefinierten Spaltenverschlüsselungsschlüsseln

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, der mit "MSSQL_" gestartet wurde. Dieses Präfix ist für Systemanbieter reserviert.

Hinweise

Benutzerdefinierte Anbieter von Speicher für Spaltenhauptschlüssel können beim Treiber auf drei verschiedenen Ebenen registriert werden. Für die drei Registrierungen gilt folgende Priorität:

• Es wird überprüft, ob die Registrierung pro Befehl leer ist.
• Wenn die Registrierung pro Befehl leer ist, wird überprüft, ob die Registrierung pro Verbindung leer ist.
• Wenn die Registrierung pro Verbindung leer ist, wird die globale Registrierung überprüft.

Wenn ein Schlüsselspeicheranbieter auf Registrierungsebene gefunden wurde, greift der Treiber bei der Suche nach einem Anbieter NICHT auf die anderen Registrierungen zurück. Wenn Anbieter registriert sind, der richtige Anbieter jedoch nicht auf einer Ebene gefunden wurde, wird eine Ausnahme ausgelöst, die nur die registrierten Anbieter in der überprüften Registrierung enthält.

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.

Dadurch wird das Wörterbuch flach kopiert, sodass die App die benutzerdefinierte Anbieterliste nach dem Festlegen nicht mehr ändern kann.