SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand 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

Örnekteki şifreleme anahtarı deposu sağlayıcılarını SqlCommand kaydeder. Bu işlev çağrıldıysa, veya RegisterColumnEncryptionKeyStoreProvidersOnConnection(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) yöntemleri kullanılarak RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) 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 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))

Parametreler

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

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

Özel durumlar

ArgumentNullException

Null bir sözlük sağlandı.

-veya-

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

-veya-

Sözlükteki bir SqlColumnEncryptionKeyStoreProvider 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.