ECDsaCng Constructors

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Initializes a new instance of the ECDsaCng class.

Overloads

ECDsaCng()	Initializes a new instance of the ECDsaCng class with a random key pair.
ECDsaCng(Int32)	Initializes a new instance of the ECDsaCng class with a specified target key size.
ECDsaCng(CngKey)	Initializes a new instance of the ECDsaCng class by using the specified CngKey object.
ECDsaCng(ECCurve)	Initializes a new instance of the ECDsaCng class whose public/private key pair is generated over the specified curve.

ECDsaCng()

Source:

Cng.NotSupported.cs

Initializes a new instance of the ECDsaCng class with a random key pair.

public:
 ECDsaCng();

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public ECDsaCng ();

Public Sub New ()

Attributes

SupportedOSPlatformAttribute

Exceptions

PlatformNotSupportedException

Cryptography Next Generation (CNG) classes are not supported on this system.

Remarks

This constructor does not generate a new public/private keypair immediately. This constructor sets the KeySize property to 521 and when a key is needed the saved size is used to identify the target curve. If a key is loaded via the ImportParameters method, or other key import method, the key size from this constructor has no meaning.

See also

• Create()

ECDsaCng(Int32)

Source:

Cng.NotSupported.cs

Initializes a new instance of the ECDsaCng class with a specified target key size.

public:
 ECDsaCng(int keySize);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public ECDsaCng (int keySize);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
new System.Security.Cryptography.ECDsaCng : int -> System.Security.Cryptography.ECDsaCng

Public Sub New (keySize As Integer)

Parameters

keySize

Int32

The size of the key. Valid key sizes are 256, 384, and 521 bits.

Attributes

SupportedOSPlatformAttribute

Exceptions

PlatformNotSupportedException

Cryptography Next Generation (CNG) classes are not supported on this system.

CryptographicException

keySize specifies an invalid length.

Remarks

This constructor does not generate a new public/private keypair immediately. This constructor sets the KeySize property to the provided value and when a key is needed the saved size is used to identify the target curve. If a key is loaded via the ImportParameters method, or other key import method, the key size from this constructor has no meaning.

See also

• Create

ECDsaCng(CngKey)

Source:

Cng.NotSupported.cs

Initializes a new instance of the ECDsaCng class by using the specified CngKey object.

public:
 ECDsaCng(System::Security::Cryptography::CngKey ^ key);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public ECDsaCng (System.Security.Cryptography.CngKey key);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
new System.Security.Cryptography.ECDsaCng : System.Security.Cryptography.CngKey -> System.Security.Cryptography.ECDsaCng

Public Sub New (key As CngKey)

Parameters

key

CngKey

The key that will be used as input to the cryptographic operations performed by the current object.

Attributes

SupportedOSPlatformAttribute

Exceptions

ArgumentException

key does not specify an Elliptic Curve Digital Signature Algorithm (ECDSA) group.

ArgumentNullException

key is null.

PlatformNotSupportedException

Cryptography Next Generation (CNG) classes are not supported on this system.

ECDsaCng(ECCurve)

Source:

Cng.NotSupported.cs

Initializes a new instance of the ECDsaCng class whose public/private key pair is generated over the specified curve.

public:
 ECDsaCng(System::Security::Cryptography::ECCurve curve);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public ECDsaCng (System.Security.Cryptography.ECCurve curve);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
new System.Security.Cryptography.ECDsaCng : System.Security.Cryptography.ECCurve -> System.Security.Cryptography.ECDsaCng

Public Sub New (curve As ECCurve)

Parameters

curve

ECCurve

The curve used to generate the public/private key pair.

Attributes

SupportedOSPlatformAttribute

Exceptions

CryptographicException

curve does not validate.

ArgumentNullException

curve is null.

PlatformNotSupportedException

if curve does not contain an Oid with a FriendlyName.

Remarks

curve must validate (that is, it must return true) when passed to the ECCurve.Validate method and must be either a named or explicit prime.