SqlConnectionStringBuilder.ServerCertificate Właściwość

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v7.1.0

Pobiera lub ustawia ścieżkę do pliku certyfikatu, aby był zgodny z certyfikatem TLS/SSL SQL Server dla połączenia. Akceptowane formaty certyfikatów to PEM, DER i CER. Jeśli zostanie określony, certyfikat SQL Server jest sprawdzany, sprawdzając, czy ServerCertificate podany jest dokładny dopasowanie. (Dostępne tylko w wersji 5.1 lub nowszej)

public:
 property System::String ^ ServerCertificate { System::String ^ get(); void set(System::String ^ value); };

public string ServerCertificate { get; set; }

member this.ServerCertificate : string with get, set

Public Property ServerCertificate As String

Wartość właściwości

String

Wartość ServerCertificate właściwości lub string.Empty jeśli żadna z nich nie została podana.

Uwagi

Ta właściwość odpowiada kluczom "Certyfikat serwera" i "ServerCertificate" w parametry połączenia.

Note

Gdy ServerCertificate zostanie określony, certyfikat przedstawiony przez serwer jest zawsze porównywany z certyfikatem załadowanym z tej ścieżki, w tym wtedy, gdy przedstawiony certyfikat już przechodzi walidację łańcucha i nazwy. Dokładne dopasowanie spełnia walidację certyfikatu.

Jeśli przedstawiony certyfikat nie jest zgodny lub nie można załadować ani przeanalizować pliku, uzgadnianie protokołu TLS kończy się niepowodzeniem; skonfigurowany ServerCertificate element nigdy nie jest ignorowany w trybie dyskretnym.

Walidacja certyfikatu może zostać wyłączona przez TrustServerCertificate=true program (z Encrypt=strictwyjątkiem elementu , w którym jest zawsze przeprowadzana walidacja). Jeśli walidacja jest wyłączona, ServerCertificate nie jest konsultowana.