SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Registra i provider dell'archivio chiavi di crittografia nell'istanza SqlConnection di . Se questa funzione è stata chiamata, tutti i provider registrati usando i metodi statici RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) verranno ignorati. Questa funzione può essere chiamata più volte. Questa operazione esegue una copia superficiale del dizionario in modo che l'app non possa modificare l'elenco di provider personalizzato dopo che è stato impostato.
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> -> unitPublic Sub RegisterColumnEncryptionKeyStoreProvidersOnConnection (customProviders As IDictionary(Of String, SqlColumnEncryptionKeyStoreProvider))Parametri
- customProviders
- IDictionary<String,SqlColumnEncryptionKeyStoreProvider>
Dizionario dei provider di chiavi di crittografia della colonna personalizzati
Eccezioni
È stato fornito un dizionario Null.
-oppure-
Una chiave stringa nel dizionario è null o vuota.
-oppure-
Un SqlColumnEncryptionKeyStoreProvider valore nel dizionario è Null.
Chiave stringa nel dizionario avviata con "MSSQL_". Questo prefisso è riservato ai provider di sistema.
Commenti
I provider di archivi chiavi master personalizzati possono essere registrati con il driver a tre livelli diversi. Di seguito viene indicata la precedenza delle tre registrazioni:
- La registrazione per comando verrà verificata se non è vuota.
- Se la registrazione per comando è vuota, la registrazione per connessione verrà verificata se non è vuota.
- Se la registrazione per connessione è vuota, viene verificata la registrazione globale.
Dopo aver individuato un provider dell'archivio chiavi a livello di registrazione, il driver NON eseguirà il fallback alle altre registrazioni per cercare un provider. Se i provider sono registrati ma il provider appropriato non viene trovato a un livello, verrà generata un'eccezione contenente solo i provider registrati nella registrazione verificata.
I provider di archivi chiavi master di colonna predefiniti disponibili per l'archivio certificati di Windows, l'archivio CNG e CSP sono preregistrati.
Questa operazione esegue una copia superficiale del dizionario in modo che l'app non possa modificare l'elenco di provider personalizzato dopo che è stato impostato.