SqlConnection.RegisterColumnEncryptionKeyStoreProvidersOnConnection 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 SqlConnection instanci. Pokud byla tato funkce volána, budou ignorováni zprostředkovatelé zaregistrovaní pomocí statických RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) metod. Tuto funkci lze volat více než jednou. Tím se provede plytké kopírování slovníku, aby aplikace nemohla po nastavení změnit seznam vlastních zprostředkovatelů.

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

Parametry

customProviders

IDictionary<String,SqlColumnEncryptionKeyStoreProvider>

Slovník zprostředkovatelů vlastních šifrovacích klíčů sloupců

Výjimky

ArgumentNullException

Byl zadán slovník s hodnotou null.

-nebo-

Klíč řetězce ve slovníku byl null nebo prázdný.

-nebo-

Hodnota SqlColumnEncryptionKeyStoreProvider ve slovníku byla null.

ArgumentException

Řetězcový klíč ve slovníku začal řetězcem "MSSQL_". Tato předpona je vyhrazena pro systémové poskytovatele.

Poznámky

Vlastní hlavní poskytovatele úložiště klíčů je možné zaregistrovat u 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 pro jednotlivé příkazy prázdná, registrace pro připojení se zkontroluje, pokud není prázdná.
• Pokud je registrace jednotlivých připojení prázdná, zkontroluje se globální registrace.

Jakmile se na úrovni registrace najde jakýkoli poskytovatel úložiště klíčů, ovladač se nevrátí k ostatním registracím, aby vyhledaly poskytovatele. Pokud jsou poskytovatelé zaregistrovaní, ale na určité úrovni se nenajde správný poskytovatel, vyvolá se výjimka obsahující pouze registrované poskytovatele v registraci, která byla zkontrolována.

Předdefinované zprostředkovatelé hlavního úložiště klíčů sloupců, kteří jsou k dispozici pro Úložiště certifikátů Windows, CNG Store a CSP, jsou předem zaregistrovaní.

Tím se provede plytké kopírování slovníku, aby aplikace nemohla po nastavení změnit seznam vlastních zprostředkovatelů.