HashAlgorithm 类

定义

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

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

示例

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

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

注解

哈希函数是新式加密的基础。 这些函数将任意长度的二进制字符串映射到固定长度的小二进制字符串,称为哈希值。 加密哈希函数具有计算上不可行的属性,它无法找到哈希到相同值的两个不同的输入。 哈希函数通常用于数字签名和数据完整性。

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

由于 SHA-1 冲突问题,Microsoft建议基于 SHA-256 或更高版本的安全模型。

实施者说明

HashAlgorithm 类继承时,必须重写以下成员: HashCore(Byte[], Int32, Int32)HashFinal()

构造函数

名称 说明
HashAlgorithm()

初始化 HashAlgorithm 类的新实例。

字段

名称 说明
HashSizeValue

表示计算哈希代码的大小(以位为单位)。

HashValue

表示计算的哈希代码的值。

State

表示哈希计算的状态。

属性

名称 说明
CanReuseTransform

获取一个值,该值指示是否可以重复使用当前转换。

CanTransformMultipleBlocks

在派生类中重写时,获取一个值,该值指示是否可以转换多个块。

Hash

获取计算的哈希代码的值。

HashSize

获取计算哈希代码的大小(以位为单位)。

InputBlockSize

在派生类中重写时,获取输入块大小。

OutputBlockSize

在派生类中重写时,获取输出块大小。

方法

名称 说明
Clear()

释放类使用 HashAlgorithm 的所有资源。

ComputeHash(Byte[], Int32, Int32)

计算指定字节数组的指定区域的哈希值。

ComputeHash(Byte[])

计算指定字节数组的哈希值。

ComputeHash(Stream)

计算指定 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 的非托管资源,并选择性地释放托管资源。

适用于

另请参阅