HashAlgorithm 类

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.dll

Source:

HashAlgorithm.cs

表示所有加密哈希算法实现均必须从中派生的基类。

public ref class HashAlgorithm abstract : IDisposable, System::Security::Cryptography::ICryptoTransform

public abstract class HashAlgorithm : IDisposable, System.Security.Cryptography.ICryptoTransform

type HashAlgorithm = class
    interface IDisposable
    interface ICryptoTransform

Public MustInherit Class HashAlgorithm
Implements ICryptoTransform, IDisposable

继承

Object

HashAlgorithm

派生

System.Security.Cryptography.KeyedHashAlgorithm

System.Security.Cryptography.MD5

System.Security.Cryptography.RIPEMD160

System.Security.Cryptography.SHA1

System.Security.Cryptography.SHA256

System.Security.Cryptography.SHA3_256

System.Security.Cryptography.SHA3_384

System.Security.Cryptography.SHA3_512

System.Security.Cryptography.SHA384

System.Security.Cryptography.SHA512

实现

IDisposable ICryptoTransform

示例

下面的代码示例计算数组的 SHA256 哈希。 此示例假定有一个预定义的字节数组 dataArray[]。 SHA256 是 的 HashAlgorithm派生类。

HashAlgorithm^ sha = SHA256::Create();
array<Byte>^ result = sha->ComputeHash( dataArray );

HashAlgorithm sha = SHA256.Create();
byte[] result = sha.ComputeHash(dataArray);

Dim sha As SHA256 = SHA256.Create()
Dim result As Byte() = sha.ComputeHash(dataArray)

注解

哈希函数是新式加密的基础。 这些函数将任意长度的二进制字符串映射到固定长度的小型二进制字符串，称为哈希值。 加密哈希函数具有 属性，在计算上无法查找哈希为同一值的两个不同输入。 哈希函数通常与数字签名一起使用并用来保持数据的完整性。

哈希用作表示大量数据的固定大小的唯一值。 如果相应的数据也匹配，则两组数据的哈希应匹配。 对数据的少量更改会导致哈希中出现大量不可预知的更改。

由于 SHA1 出现冲突问题，Microsoft 建议使用基于 SHA256 或更好的安全模型。

实施者说明

从 HashAlgorithm 类继承时，必须重写以下成员： HashCore(Byte[], Int32, Int32) 和 HashFinal()。

构造函数

HashAlgorithm()

初始化 HashAlgorithm 类的新实例。

字段

HashSizeValue	表示计算所得的哈希代码的大小（以位为单位）。
HashValue	表示计算所得的哈希代码的值。
State	表示哈希计算的状态。

属性

CanReuseTransform	获取一个值，该值指示是否可重复使用当前转换。
CanTransformMultipleBlocks	当在派生类中重写时，获取一个值，该值指示是否可以转换多个块。
Hash	获取计算所得的哈希代码的值。
HashSize	获取计算所得的哈希代码的大小（以位为单位）。
InputBlockSize	当在派生类中重写时，获取输入块的大小。
OutputBlockSize	当在派生类中重写时，获取输出块的大小。

方法

Clear()	释放 HashAlgorithm 类使用的所有资源。
ComputeHash(Byte[])	计算指定字节数组的哈希值。
ComputeHash(Byte[], Int32, Int32)	计算指定字节数组的指定区域的哈希值。
ComputeHash(Stream)	计算指定 Stream 对象的哈希值。
ComputeHashAsync(Stream, CancellationToken)	异步计算指定 Stream 对象的哈希值。
Create()	已过时. 创建哈希算法的默认实现的实例。
Create(String)	已过时. 创建哈希算法的指定实现的实例。
Dispose()	释放 HashAlgorithm 类的当前实例所使用的所有资源。
Dispose(Boolean)	释放由 HashAlgorithm 占用的非托管资源，还可以另外再释放托管资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
HashCore(Byte[], Int32, Int32)	当在派生类中重写时，将写入对象的数据路由到哈希算法以计算哈希值。
HashCore(ReadOnlySpan<Byte>)	将写入对象的数据路由到哈希算法以计算哈希值。
HashFinal()	在派生类中重写时，在加密哈希算法处理最后一个数据后结束哈希计算。
Initialize()	将哈希算法重置为其初始状态。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	计算输入字节数组指定区域的哈希值，并将输入字节数组指定区域复制到输出字节数组的指定区域。
TransformFinalBlock(Byte[], Int32, Int32)	计算指定字节数组的指定区域的哈希值。
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	尝试计算指定字节数组的哈希值。
TryHashFinal(Span<Byte>, Int32)	在哈希算法处理最后一个数据后，尝试结束哈希计算。

另请参阅

• 加密服务