SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zaregistruje poskytovatele úložiště šifrovacích klíčů v SqlCommand instanci. Pokud byla tato funkce volána, budou ignorováni zprostředkovatelé zaregistrovaní pomocí RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) metod nebo RegisterColumnEncryptionKeyStoreProvidersOnConnection(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) . Tuto funkci je možné volat více než jednou. Tím se slovník zkopíruje jen povrchně, aby aplikace nemohla po nastavení změnit seznam vlastních zprostředkovatelů.
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>
Slovník zprostředkovatelů šifrovacích klíčů vlastních sloupců
Výjimky
Byl zadán slovník s hodnotou null.
-nebo-
Klíč řetězce ve slovníku měl hodnotu null nebo byl prázdný.
-nebo-
Hodnota SqlColumnEncryptionKeyStoreProvider ve slovníku měla hodnotu null.
Řetězcový klíč ve slovníku začínal řetězcem "MSSQL_". Tato předpona je vyhrazená pro systémové poskytovatele.
Poznámky
Vlastní poskytovatele úložiště hlavních klíčů je možné zaregistrovat pomocí ovladače ve třech různých vrstvách. Priorita těchto tří registrací je následující:
- Registrace jednotlivých příkazů se zkontroluje, pokud není prázdná.
- Pokud je registrace jednotlivých příkazů prázdná, registrace pro připojení se zkontroluje, pokud není prázdná.
- Pokud je registrace jednotlivých připojení prázdná, globální registrace se zkontroluje.
Jakmile se na úrovni registrace najde jakýkoli poskytovatel úložiště klíčů, ovladač se NEBUDE vracet k ostatním registracím a hledat poskytovatele. Pokud jsou zprostředkovatelé zaregistrovaní, ale na určité úrovni se nenajde správný zprostředkovatel, vyvolá se výjimka obsahující pouze zaregistrované zprostředkovatele v registraci, která byla zkontrolována.
Předdefinované zprostředkovatelé hlavního úložiště klíčů sloupců, kteří jsou k dispozici pro Windows Certificate Store, CNG Store a CSP, jsou předem zaregistrovaní.
Tím se slovník zkopíruje jen povrchně, aby aplikace nemohla po nastavení změnit seznam vlastních zprostředkovatelů.