SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Rejestruje dostawców magazynu kluczy szyfrowania w wystąpieniu SqlCommand . Jeśli ta funkcja została wywołana, każdy dostawca zarejestrowany przy użyciu RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) metod lub RegisterColumnEncryptionKeyStoreProvidersOnConnection(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) zostanie zignorowany. Ta funkcja może być wywoływana więcej niż raz. Powoduje to płytkie kopiowanie słownika, dzięki czemu aplikacja nie może zmienić listy dostawców niestandardowych po jej ustawieniu.

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

Parametry

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Słownik niestandardowych dostawców kluczy szyfrowania kolumn

Wyjątki

ArgumentNullException

Podano słownik o wartości null.

-lub-

Klucz ciągu w słowniku miał wartość null lub był pusty.

-lub-

SqlColumnEncryptionKeyStoreProvider Wartość w słowniku miała wartość null.

ArgumentException

Klucz ciągu w słowniku rozpoczął się od ciągu "MSSQL_". Ten prefiks jest zarezerwowany dla dostawców systemu.

Uwagi

Niestandardowi dostawcy magazynu kluczy głównych mogą być zarejestrowani za pomocą sterownika w trzech różnych warstwach. Pierwszeństwo trzech rejestracji jest następujące:

• Rejestracja poszczególnych poleceń zostanie sprawdzona, jeśli nie jest pusta.
• Jeśli rejestracja poszczególnych poleceń jest pusta, rejestracja poszczególnych połączeń zostanie sprawdzona, czy nie jest pusta.
• Jeśli rejestracja dla połączenia jest pusta, rejestracja globalna zostanie sprawdzona.

Po znalezieniu dowolnego dostawcy magazynu kluczy na poziomie rejestracji sterownik NIE wróci do innych rejestracji w celu wyszukania dostawcy. Jeśli dostawcy są zarejestrowani, ale odpowiedni dostawca nie zostanie znaleziony na poziomie, zostanie zgłoszony wyjątek zawierający tylko zarejestrowanych dostawców w sprawdzonej rejestracji.

Wbudowani dostawcy magazynu kluczy głównych kolumn, którzy są dostępni dla magazynu certyfikatów systemu Windows, magazynu CNG i dostawcy CSP są wstępnie zarejestrowani.

Powoduje to płytkie kopiowanie słownika, dzięki czemu aplikacja nie może zmienić listy dostawców niestandardowych po jej ustawieniu.