HashAlgorithm 类

定义

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

public ref class HashAlgorithm abstract : IDisposable, System::Security::Cryptography::ICryptoTransform
public ref class HashAlgorithm abstract : IDisposable
public ref class HashAlgorithm abstract : System::Security::Cryptography::ICryptoTransform
public abstract class HashAlgorithm : IDisposable, System.Security.Cryptography.ICryptoTransform
public abstract class HashAlgorithm : IDisposable
public abstract class HashAlgorithm : System.Security.Cryptography.ICryptoTransform
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HashAlgorithm : System.Security.Cryptography.ICryptoTransform
type HashAlgorithm = class
    interface IDisposable
    interface ICryptoTransform
type HashAlgorithm = class
    interface IDisposable
type HashAlgorithm = class
    interface ICryptoTransform
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type HashAlgorithm = class
    interface ICryptoTransform
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type HashAlgorithm = class
    interface IDisposable
    interface ICryptoTransform
Public MustInherit Class HashAlgorithm
Implements ICryptoTransform, IDisposable
Public MustInherit Class HashAlgorithm
Implements IDisposable
Public MustInherit Class HashAlgorithm
Implements ICryptoTransform
继承
HashAlgorithm
派生
属性
实现

示例

下面的代码示例计算数组的 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)

在哈希算法处理最后一个数据后,尝试结束哈希计算。

显式接口实现

IDisposable.Dispose()

释放由 HashAlgorithm 占用的非托管资源,还可以另外再释放托管资源。

适用于

另请参阅