Export (0) Print
Expand All

RSACryptoServiceProvider Class

Performs asymmetric encryption and decryption using the implementation of the RSA algorithm provided by the cryptographic service provider (CSP). This class cannot be inherited.

For a list of all members of this type, see RSACryptoServiceProvider Members.

System.Object
   System.Security.Cryptography.AsymmetricAlgorithm
      System.Security.Cryptography.RSA
         System.Security.Cryptography.RSACryptoServiceProvider

[Visual Basic]
NotInheritable Public Class RSACryptoServiceProvider
   Inherits RSA
[C#]
public sealed class RSACryptoServiceProvider : RSA
[C++]
public __gc __sealed class RSACryptoServiceProvider : public RSA
[JScript]
public class RSACryptoServiceProvider extends RSA

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

This is the default implementation of RSA.

Example

[C#] 
using System;
using System.Security.Cryptography;
using System.Text;

class RSACSPSample
{

    static void Main()
    {
        try
        {
            //Create a UnicodeEncoder to convert between byte array and string.
            UnicodeEncoding ByteConverter = new UnicodeEncoding();

            //Create byte arrays to hold original, encrypted, and decrypted data.
            byte[] dataToEncrypt = ByteConverter.GetBytes("Data to Encrypt");
            byte[] encryptedData;
            byte[] decryptedData;
            
            //Create a new instance of RSACryptoServiceProvider to generate
            //public and private key data.
            RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();

            //Pass the data to ENCRYPT, the public key information 
            //(using RSACryptoServiceProvider.ExportParameters(false),
            //and a boolean flag specifying no OAEP padding.
            encryptedData = RSAEncrypt(dataToEncrypt,RSA.ExportParameters(false), false);

            //Pass the data to DECRYPT, the private key information 
            //(using RSACryptoServiceProvider.ExportParameters(true),
            //and a boolean flag specifying no OAEP padding.
            decryptedData = RSADecrypt(encryptedData,RSA.ExportParameters(true), false);

            //Display the decrypted plaintext to the console. 
            Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData));
        }
        catch(ArgumentNullException)
        {
            //Catch this exception in case the encryption did
            //not succeed.
            Console.WriteLine("Encryption failed.");

        }
    }

    static public byte[] RSAEncrypt(byte[] DataToEncrypt, RSAParameters RSAKeyInfo, bool DoOAEPPadding)
    {
        try
        {    
            //Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();

            //Import the RSA Key information. This only needs
            //toinclude the public key information.
            RSA.ImportParameters(RSAKeyInfo);

            //Encrypt the passed byte array and specify OAEP padding.  
            //OAEP padding is only available on Microsoft Windows XP or
            //later.  
            return RSA.Encrypt(DataToEncrypt, DoOAEPPadding);
        }
        //Catch and display a CryptographicException  
        //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }

    }

    static public byte[] RSADecrypt(byte[] DataToDecrypt, RSAParameters RSAKeyInfo,bool DoOAEPPadding)
    {
        try
        {
            //Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();

            //Import the RSA Key information. This needs
            //to include the private key information.
            RSA.ImportParameters(RSAKeyInfo);

            //Decrypt the passed byte array and specify OAEP padding.  
            //OAEP padding is only available on Microsoft Windows XP or
            //later.  
            return RSA.Decrypt(DataToDecrypt, DoOAEPPadding);
        }
        //Catch and display a CryptographicException  
        //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.ToString());

            return null;
        }

    }
}

[C++] 
#using <mscorlib.dll>
using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Text;

Byte RSAEncrypt(Byte DataToEncrypt[], RSAParameters RSAKeyInfo, bool DoOAEPPadding)[]
{
    try
    {    
        //Create a new instance of RSACryptoServiceProvider.
        RSACryptoServiceProvider* RSA = new RSACryptoServiceProvider();

        //Import the RSA Key information. This only needs
        //toinclude the public key information.
        RSA->ImportParameters(RSAKeyInfo);

        //Encrypt the passed byte array and specify OAEP padding.  
        //OAEP padding is only available on Microsoft Windows XP or
        //later.  
        return RSA->Encrypt(DataToEncrypt, DoOAEPPadding);
    }
    //Catch and display a CryptographicException  
    //to the console.
    catch(CryptographicException* e)
    {
        Console::WriteLine(e->Message);

        return 0;
    }

}

Byte RSADecrypt(Byte DataToDecrypt[], RSAParameters RSAKeyInfo,bool DoOAEPPadding)[]
{
    try
    {
        //Create a new instance of RSACryptoServiceProvider.
        RSACryptoServiceProvider* RSA = new RSACryptoServiceProvider();

        //Import the RSA Key information. This needs
        //to include the private key information.
        RSA->ImportParameters(RSAKeyInfo);

        //Decrypt the passed byte array and specify OAEP padding.  
        //OAEP padding is only available on Microsoft Windows XP or
        //later.  
        return RSA->Decrypt(DataToDecrypt, DoOAEPPadding);
    }
    //Catch and display a CryptographicException  
    //to the console.
    catch(CryptographicException* e)
    {
        Console::WriteLine(e);

        return 0;
    }

}

int main()
{
    try
    {
        //Create a UnicodeEncoder to convert between byte array and string.
        UnicodeEncoding* ByteConverter = new UnicodeEncoding();

        //Create byte arrays to hold original, encrypted, and decrypted data.
        Byte dataToEncrypt[] = ByteConverter->GetBytes(S"Data to Encrypt");
        Byte encryptedData[];
        Byte decryptedData[];

        //Create a new instance of RSACryptoServiceProvider to generate
        //public and private key data.
        RSACryptoServiceProvider* RSA = new RSACryptoServiceProvider();

        //Pass the data to ENCRYPT, the public key information 
        //(using RSACryptoServiceProvider.ExportParameters(false),
        //and a boolean flag specifying no OAEP padding.
        encryptedData = RSAEncrypt(dataToEncrypt,RSA->ExportParameters(false), false);

        //Pass the data to DECRYPT, the private key information 
        //(using RSACryptoServiceProvider.ExportParameters(true),
        //and a boolean flag specifying no OAEP padding.
        decryptedData = RSADecrypt(encryptedData,RSA->ExportParameters(true), false);

        //Display the decrypted plaintext to the console. 
        Console::WriteLine(S"Decrypted plaintext: {0}", ByteConverter->GetString(decryptedData));
    }
    catch(ArgumentNullException*)
    {
        //Catch this exception in case the encryption did
        //not succeed.
        Console::WriteLine(S"Encryption failed.");

    }
}

[Visual Basic] 
Try

    'Create a new RSACryptoServiceProvider object. 
    Dim RSA As New RSACryptoServiceProvider()

    'Export the key information to an RSAParameters object.
    'Pass false to export the public key information or pass
    'true to export public and private key information.
    Dim RSAParams As RSAParameters = RSA.ExportParameters(False)


Catch e As CryptographicException
    'Catch this exception in case the encryption did
    'not succeed.
    Console.WriteLine(e.Message)
End Try

[C#] 
try
{
    //Create a new RSACryptoServiceProvider object.
    RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();


    //Export the key information to an RSAParameters object.
    //Pass false to export the public key information or pass
    //true to export public and private key information.
    RSAParameters RSAParams = RSA.ExportParameters(false);


}
catch(CryptographicException e)
{
    //Catch this exception in case the encryption did
    //not succeed.
    Console.WriteLine(e.Message);

}

[C++] 
try {
    //Create a new RSACryptoServiceProvider Object*.
    RSACryptoServiceProvider* RSA = new RSACryptoServiceProvider();

    //Export the key information to an RSAParameters object.
    //Pass false to export the public key information or pass
    //true to export public and private key information.
    RSAParameters RSAParams = RSA->ExportParameters(false);
} catch (CryptographicException* e) {
    //Catch this exception in case the encryption did
    //not succeed.
    Console::WriteLine(e->Message);
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Security.Cryptography

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: Mscorlib (in Mscorlib.dll)

See Also

RSACryptoServiceProvider Members | System.Security.Cryptography Namespace | Cryptographic Services

Show:
© 2014 Microsoft