SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Registriert die Verschlüsselungsschlüsselspeicheranbieter in der SqlCommand -Instanz. Wenn diese Funktion aufgerufen wurde, werden alle Anbieter ignoriert, die mit den RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) Methoden oder RegisterColumnEncryptionKeyStoreProvidersOnConnection(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) registriert wurden. Diese Funktion kann mehrmals aufgerufen werden. Dadurch wird das Wörterbuch flach kopiert, sodass die App die Liste der benutzerdefinierten Anbieter nicht ändern kann, nachdem sie festgelegt wurde.

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

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

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

Public Sub RegisterColumnEncryptionKeyStoreProvidersOnCommand (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 begann mit "MSSQL_". Dieses Präfix ist Systemanbietern vorbehalten.

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 Liste der benutzerdefinierten Anbieter nicht ändern kann, nachdem sie festgelegt wurde.