SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection Metodo

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

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> -> unit

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

Parametri

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Dizionario dei provider di chiavi di crittografia della colonna personalizzati

Eccezioni

ArgumentNullException

È stato fornito un dizionario Null.

-oppure-

Una chiave stringa nel dizionario è null o vuota.

-oppure-

Un SqlColumnEncryptionKeyStoreProvider valore nel dizionario è Null.

ArgumentException

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.