SHA256.Create Method

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Allows specific implementations of this abstract class to be instantiated.

Overloads

Create()	Creates an instance of the default implementation of SHA256.
Create(String)	Obsolete. Creates an instance of a specified implementation of SHA256.

Create()

Source:

SHA256.cs

Creates an instance of the default implementation of SHA256.

public:
 static System::Security::Cryptography::SHA256 ^ Create();

public static System.Security.Cryptography.SHA256 Create ();

static member Create : unit -> System.Security.Cryptography.SHA256

Public Shared Function Create () As SHA256

Returns

SHA256

A new instance of SHA256. On the .NET Framework, this method creates an instance of the SHA256Managed class if FIPS mode is not active; if FIPS mode is active, it creates an instance of the SHA256Cng class. On .NET Core, it returns an instance of a private class derived from SHA256.

Exceptions

TargetInvocationException

On the .NET Framework 4.6.1 and earlier versions only: The algorithm was used with Federal Information Processing Standards (FIPS) mode enabled, but is not FIPS compatible.

See also

• Cryptographic Services

Create(String)

Source:

SHA256.cs

Caution

Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.

Creates an instance of a specified implementation of SHA256.

public:
 static System::Security::Cryptography::SHA256 ^ Create(System::String ^ hashName);

[System.Obsolete("Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.", DiagnosticId="SYSLIB0045", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Security.Cryptography.SHA256? Create (string hashName);

[<System.Obsolete("Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.", DiagnosticId="SYSLIB0045", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : string -> System.Security.Cryptography.SHA256

Public Shared Function Create (hashName As String) As SHA256

Parameters

hashName

String

The name of the specific implementation of SHA256 to be used.

Returns

SHA256

A new instance of SHA256 using the specified implementation.

Attributes

ObsoleteAttribute

Exceptions

TargetInvocationException

On the .NET Framework only: FIPS mode is enabled, but hashName requests SHA256Managed, which is not FIPS compatible.

Remarks

The .NET Framework includes the implementations and their associated hashName values:

Implementation	hashName
SHA256Managed	SHA256 SHA-256 System.Security.Cryptography.SHA256
SHA256Cng	System.Security.Cryptography.SHA256Cng
SHA256CryptoServiceProvider	System.Security.Cryptography.SHA256CryptoServiceProvider

See also

• Cryptographic Services