SqlConnectionStringBuilder.TrustServerCertificate Property

  • Reference

Definition

Namespace:
Microsoft.Data.SqlClient
Assembly:
Microsoft.Data.SqlClient.dll
Package:
Microsoft.Data.SqlClient v1.0.19269.1
Package:
Microsoft.Data.SqlClient v1.1.4
Package:
Microsoft.Data.SqlClient v2.0.1
Package:
Microsoft.Data.SqlClient v2.1.4
Package:
Microsoft.Data.SqlClient v3.0.1
Package:
Microsoft.Data.SqlClient v3.1.0
Package:
Microsoft.Data.SqlClient v4.0.1
Package:
Microsoft.Data.SqlClient v4.1.0
Package:
Microsoft.Data.SqlClient v5.0.0
Package:
Microsoft.Data.SqlClient v5.1.0
Package:
Microsoft.Data.SqlClient v5.2.0

Gets or sets a value that indicates whether the channel will be encrypted while bypassing walking the certificate chain to validate trust.

public:
 property bool TrustServerCertificate { bool get(); void set(bool value); };
public bool TrustServerCertificate { get; set; }
member this.TrustServerCertificate : bool with get, set
Public Property TrustServerCertificate As Boolean

Property Value

Boolean

A boolean. The default is false.

Remarks

This property corresponds to the "Trust Server Certificate" and "TrustServerCertificate" keys within the connection string.

When Trust Server Certificate is set to true, the transport layer will use TLS to encrypt the channel and bypass walking the certificate chain to validate trust. If Trust Server Certificate is set to true and encryption is enforced by target server, the encryption level specified on the server will be used even if Encrypt is set to false. The connection will fail otherwise.

For more information, see Encryption Hierarchy and Using Encryption Without Validation.

Applies to