X509Certificate.Import Method (String)

Note: This method is new in the .NET Framework version 2.0.

Populates the X509Certificate object with information from a certificate file.

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

[ComVisibleAttribute(false)] 
public virtual void Import (
	string fileName
)
/** @attribute ComVisibleAttribute(false) */ 
public void Import (
	String fileName
)
ComVisibleAttribute(false) 
public function Import (
	fileName : String
)

Parameters

fileName

The name of a certificate file represented as a string.

Exception typeCondition

ArgumentException

The fileName parameter is a null reference (Nothing in Visual Basic).

This method uses a certificate file (such as a file with a .cer extension) that represents an X.509 certificate, and populates the X509Certificate object with the certificate that the file contains.

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

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"Certificate.cer";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate;
   cert->Import(Certificate);
   
   // Get the value.
   String^ resultsTrue = cert->ToString( true );
   
   // Display the value to the console.
   Console::WriteLine( resultsTrue );
   
   // Get the value.
   String^ resultsFalse = cert->ToString( false );
   
   // Display the value to the console.
   Console::WriteLine( resultsFalse );
}


  • FileIOPermission  for permission to read the file described by the fileName parameter. Associated enumeration: Read Security action: Demand
  • KeyContainerPermission  for permission to create a key container. Associated enumeration: Create Security action: Demand

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: