SslStreamCertificateContext.Create Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
| Create(X509Certificate2, X509Certificate2Collection, Boolean) |
Attempts to build the certificate chain from the provided certificates. |
| Create(X509Certificate2, X509Certificate2Collection, Boolean, SslCertificateTrust) |
Attempts to build the certificate chain from the provided certificates. |
Attempts to build the certificate chain from the provided certificates.
public:
static System::Net::Security::SslStreamCertificateContext ^ Create(System::Security::Cryptography::X509Certificates::X509Certificate2 ^ target, System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ additionalCertificates, bool offline);public static System.Net.Security.SslStreamCertificateContext Create(System.Security.Cryptography.X509Certificates.X509Certificate2 target, System.Security.Cryptography.X509Certificates.X509Certificate2Collection? additionalCertificates, bool offline);public static System.Net.Security.SslStreamCertificateContext Create(System.Security.Cryptography.X509Certificates.X509Certificate2 target, System.Security.Cryptography.X509Certificates.X509Certificate2Collection? additionalCertificates, bool offline = false);static member Create : System.Security.Cryptography.X509Certificates.X509Certificate2 * System.Security.Cryptography.X509Certificates.X509Certificate2Collection * bool -> System.Net.Security.SslStreamCertificateContextPublic Shared Function Create (target As X509Certificate2, additionalCertificates As X509Certificate2Collection, offline As Boolean) As SslStreamCertificateContextPublic Shared Function Create (target As X509Certificate2, additionalCertificates As X509Certificate2Collection, Optional offline As Boolean = false) As SslStreamCertificateContextParameters
- target
- X509Certificate2
The server certificate.
- additionalCertificates
- X509Certificate2Collection
Supplementary certificates used to build the certificate chain.
- offline
- Boolean
false to indicate that the missing certificates can be downloaded from the network; true to indicate that only available X509Certificate stores should be searched for missing certificates.
Returns
The certificate context with the newly created certificate chain.
Exceptions
target doesn't have an associated private key.
Remarks
The provided certificates should not be disposed during the lifetime of the SslStreamCertificateContext.
Important
The target certificate must include a private key.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | 5, 6, 7, 8, 9, 10 |
Attempts to build the certificate chain from the provided certificates.
public static System.Net.Security.SslStreamCertificateContext Create(System.Security.Cryptography.X509Certificates.X509Certificate2 target, System.Security.Cryptography.X509Certificates.X509Certificate2Collection? additionalCertificates, bool offline = false, System.Net.Security.SslCertificateTrust? trust = default);static member Create : System.Security.Cryptography.X509Certificates.X509Certificate2 * System.Security.Cryptography.X509Certificates.X509Certificate2Collection * bool * System.Net.Security.SslCertificateTrust -> System.Net.Security.SslStreamCertificateContextPublic Shared Function Create (target As X509Certificate2, additionalCertificates As X509Certificate2Collection, Optional offline As Boolean = false, Optional trust As SslCertificateTrust = Nothing) As SslStreamCertificateContextParameters
- target
- X509Certificate2
The server certificate.
- additionalCertificates
- X509Certificate2Collection
Supplementary certificates used to build the certificate chain.
- offline
- Boolean
false to indicate that the missing certificates can be downloaded from the network; true to indicate that only available X509Certificate stores should be searched for missing certificates.
- trust
- SslCertificateTrust
An optional trust policy, to replace the default system trust.
Returns
The certificate context with the newly created certificate chain.
Exceptions
target doesn't have an associated private key.
Remarks
The provided certificates should not be disposed during the lifetime of the SslStreamCertificateContext.
Important
The target certificate must include a private key.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | 6, 7, 8, 9, 10 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: