SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendaftarkan penyedia penyimpanan kunci enkripsi pada SqlConnection instans. Jika fungsi ini telah dipanggil, penyedia apa pun yang terdaftar menggunakan metode statis RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) akan diabaikan. Fungsi ini dapat dipanggil lebih dari sekali. Ini melakukan penyalinan dangkal kamus sehingga aplikasi tidak dapat mengubah daftar penyedia kustom setelah ditetapkan.

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>

Kamus penyedia kunci enkripsi kolom kustom

Pengecualian

ArgumentNullException

Kamus null disediakan.

-atau-

Kunci string dalam kamus null atau kosong.

-atau-

Nilai SqlColumnEncryptionKeyStoreProvider dalam kamus null.

ArgumentException

Kunci string dalam kamus dimulai dengan "MSSQL_". Awalan ini dicadangkan untuk penyedia sistem.

Keterangan

Penyedia penyimpanan kunci master kustom dapat didaftarkan ke driver pada tiga lapisan yang berbeda. Prioritas dari tiga pendaftaran adalah sebagai berikut:

• Pendaftaran per perintah akan diperiksa jika tidak kosong.
• Jika pendaftaran per perintah kosong, pendaftaran per koneksi akan diperiksa jika tidak kosong.
• Jika pendaftaran per koneksi kosong, pendaftaran global akan diperiksa.

Setelah penyedia penyimpanan kunci ditemukan pada tingkat pendaftaran, driver TIDAK akan kembali ke pendaftaran lain untuk mencari penyedia. Jika penyedia terdaftar tetapi penyedia yang tepat tidak ditemukan pada tingkat, pengecualian hanya akan dilemparkan berisi penyedia terdaftar dalam pendaftaran yang diperiksa.

Penyedia penyimpanan kunci master kolom bawaan yang tersedia untuk Windows Certificate Store, CNG Store, dan CSP telah didaftarkan sebelumnya.

Ini melakukan penyalinan dangkal kamus sehingga aplikasi tidak dapat mengubah daftar penyedia kustom setelah ditetapkan.