X509Certificate Constructor (String)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file.

Namespace:   System.Security.Cryptography.X509Certificates
Assembly:  mscorlib (in mscorlib.dll)

Public Sub New (
	fileName As String
)

Parameters

fileName
Type: System.String

The name of a PKCS7 signed file.

Exception Condition
CryptographicException

An error with the certificate occurs. For example:

  • The certificate file does not exist.

  • The certificate is invalid.

  • The certificate's password is incorrect.

ArgumentException

The fileName parameter is null.

ASN.1 DER is the only certificate format supported by this class.

If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

The following example loads an X.509 certificate from a file, calls the ToString method, and displays the results to the console.

Imports System
Imports System.Security.Cryptography.X509Certificates

Module X509

    Sub Main()

        ' The path to the certificate.
        Dim Certificate As String = "Certificate.cer"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)

        ' Get the value.
        Dim resultsTrue As String = cert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = cert.ToString(False)

        ' Display the value to the console.
        Console.WriteLine(resultsFalse)

    End Sub
End Module

FileIOPermission

for permission to read the file described by the fileName parameter. Security action: Demand. Associated enumeration: EnvironmentPermissionAccess.Read

KeyContainerPermission

for permission to create a key container. Security action: Demand. Associated enumeration: KeyContainerPermissionFlags.Create

.NET Framework
Available since 2.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: