SqlCommand.RegisterColumnEncryptionKeyStoreProvidersOnCommand Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

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

ArgumentNullException

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.

ArgumentException

Ř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ů.