• Article

RSACryptoServiceProvider Constructor (Int32, CspParameters)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the RSACryptoServiceProvider class with the specified key size and parameters.

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

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Sub New ( _
    keySize As Integer, _
    parameters As CspParameters _
)

[SecuritySafeCriticalAttribute]
public RSACryptoServiceProvider(
    int keySize,
    CspParameters parameters
)

Parameters

Exceptions

Exception Condition
CryptographicException

The CSP cannot be acquired.

-or-

The key cannot be created.

Remarks

This constructor creates or reuses a key container specified using the KeyContainerName field of the parameters parameter.

By default, this constructor creates an Exchange key pair suitable to encrypt session keys so that they can be safely stored and exchanged with other users. The generated key corresponds to a key generated using the AT_KEYEXCHANGE value used in the unmanaged Microsoft Cryptographic API (CAPI).

You can create a Signature key pair suitable for authenticating (digitally signed) messages or files by setting the KeyNumber field of the parameters parameter to the Signature value. This type of key corresponds to the AT_SIGNATURE value used in CAPI.

If you create an RSACryptoServiceProvider object with the Exchange value specified and then create another RSACryptoServiceProvider object with the Signature value specified, both keys will be placed in a single container if both objects specify the same key container name.

To create a key that is compatible with stong-name signing using the RSACryptoServiceProvider class, you must create a Signature key pair.

Version Information

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.