Export (0) Print
Expand All

CngKey.Create Method (CngAlgorithm, String, CngKeyCreationParameters)

Creates a named CngKey object that provides the specified algorithm, using the supplied key creation parameters.

Namespace:  System.Security.Cryptography
Assembly:  System.Core (in System.Core.dll)

public static CngKey Create(
	CngAlgorithm algorithm,
	string keyName,
	CngKeyCreationParameters creationParameters


Type: System.Security.Cryptography.CngAlgorithm

The algorithm that the key will be used with.

Type: System.String

The key name. If a name is not provided, the key will not be persisted.

Type: System.Security.Cryptography.CngKeyCreationParameters

An object that specifies advanced parameters for the method, including the CngProvider.

Return Value

Type: System.Security.Cryptography.CngKey
A persisted or ephemeral key that provides the specified algorithm.


algorithm is null.


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


All other errors.

If keyName is provided, this overload creates a persisted key. If keyName is not provided, the key will be ephemeral.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

© 2014 Microsoft