SourceText.GetChecksum 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
由 确定的 ChecksumAlgorithm加密校验和。 如果使用任何采用 byte[]
或 Stream) 的方法,则使用用于生成此 SourceText (的原始From
字节进行计算。 否则,通过使用提供的 Encoding) 将此SourceText写回到 Stream (并计算该) 的哈希来计算。
public:
System::Collections::Immutable::ImmutableArray<System::Byte> GetChecksum();
public System.Collections.Immutable.ImmutableArray<byte> GetChecksum ();
member this.GetChecksum : unit -> System.Collections.Immutable.ImmutableArray<byte>
Public Function GetChecksum () As ImmutableArray(Of Byte)
返回
注解
SourceText两个具有相同内容的不同实例 (看到 ContentEquals(SourceText)) 可能会对此方法产生不同的结果。 这是因为不同的原始字节最终可能会得到相同的最终内容。 例如,具有字节顺序标记的 utf8 流将生成与没有字节顺序标记的 utf8 流相同的内容。 但是,这些前言字节将是校验和的一部分,导致不同的结果。
同样,在正常情况下,具有不同内容的两SourceText个不同实例可以具有相同的校验和。 这是因为使用 Encoding 可能会导致将不同的字符映射到同一 个编码 字节序列。
因此,此函数只应由需要知道原始内容字节中的确切 SHA 哈希的客户端使用,而不能用于其他目的。