SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Şifreleme anahtarı deposu sağlayıcılarını örneğe SqlConnection kaydeder. Bu işlev çağrıldıysa, statik RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) yöntemler kullanılarak kaydedilen tüm sağlayıcılar yoksayılır. Bu işlev birden çok kez çağrılabilir. Bu, uygulamanın ayarlandıktan sonra özel sağlayıcı listesini değiştirememesi için sözlüğün sığ bir şekilde kopyalanmasını yapar.

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

Parametreler

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Özel sütun şifreleme anahtarı sağlayıcılarının sözlüğü

Özel durumlar

ArgumentNullException

Null sözlük sağlandı.

-veya-

Sözlükteki bir dize anahtarı null veya boştu.

-veya-

SqlColumnEncryptionKeyStoreProvider Sözlükteki bir değer null idi.

ArgumentException

Sözlükteki bir dize anahtarı "MSSQL_" ile başladı. Bu ön ek sistem sağlayıcıları için ayrılmıştır.

Açıklamalar

Özel ana anahtar deposu sağlayıcıları üç farklı katmanda sürücüye kaydedilebilir. Üç kaydın önceliği aşağıdaki gibidir:

• Komut başına kayıt boş değilse denetlenecektir.
• Komut başına kayıt boşsa, bağlantı başına kayıt boş değilse denetlenecektir.
• Bağlantı başına kayıt boşsa genel kayıt denetlenecektir.

Herhangi bir anahtar deposu sağlayıcısı kayıt düzeyinde bulunduktan sonra, sürücü sağlayıcıyı aramak için diğer kayıtlara geri dönmeZ . Sağlayıcılar kayıtlıysa ancak uygun sağlayıcı bir düzeyde bulunamazsa, yalnızca denetlenen kayıttaki kayıtlı sağlayıcıları içeren bir özel durum oluşturulur.

Windows Sertifika Deposu, CNG Mağazası ve CSP için kullanılabilen yerleşik sütun ana anahtar deposu sağlayıcıları önceden kaydedilmiştir.

Bu, uygulamanın ayarlandıktan sonra özel sağlayıcı listesini değiştirememesi için sözlüğün sığ bir şekilde kopyalanmasını yapar.