SHA256 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
計算 SHA256 輸入資料的雜湊值。
public ref class SHA256 abstract : System::Security::Cryptography::HashAlgorithmpublic abstract class SHA256 : System.Security.Cryptography.HashAlgorithm[System.Runtime.InteropServices.ComVisible(true)]
public abstract class SHA256 : System.Security.Cryptography.HashAlgorithmtype SHA256 = class
inherit HashAlgorithm[<System.Runtime.InteropServices.ComVisible(true)>]
type SHA256 = class
inherit HashAlgorithmPublic MustInherit Class SHA256
Inherits HashAlgorithm- 繼承
- 衍生
- 屬性
範例
以下範例計算目錄中所有檔案的 SHA-256 雜湊值。
using System;
using System.IO;
using System.Security.Cryptography;
public class HashDirectory
{
public static void Main(string[] args)
{
if (args.Length < 1)
{
Console.WriteLine("No directory selected.");
return;
}
string directory = args[0];
if (Directory.Exists(directory))
{
// Create a DirectoryInfo object representing the specified directory.
var dir = new DirectoryInfo(directory);
// Get the FileInfo objects for every file in the directory.
FileInfo[] files = dir.GetFiles();
// Initialize a SHA256 hash object.
using (SHA256 mySHA256 = SHA256.Create())
{
// Compute and print the hash values for each file in directory.
foreach (FileInfo fInfo in files)
{
using (FileStream fileStream = fInfo.Open(FileMode.Open))
{
try
{
// Create a fileStream for the file.
// Be sure it's positioned to the beginning of the stream.
fileStream.Position = 0;
// Compute the hash of the fileStream.
byte[] hashValue = mySHA256.ComputeHash(fileStream);
// Write the name and hash value of the file to the console.
Console.Write($"{fInfo.Name}: ");
PrintByteArray(hashValue);
}
catch (IOException e)
{
Console.WriteLine($"I/O Exception: {e.Message}");
}
catch (UnauthorizedAccessException e)
{
Console.WriteLine($"Access Exception: {e.Message}");
}
}
}
}
}
else
{
Console.WriteLine("The directory specified could not be found.");
}
}
// Display the byte array in a readable format.
public static void PrintByteArray(byte[] array)
{
for (int i = 0; i < array.Length; i++)
{
Console.Write($"{array[i]:X2}");
if ((i % 4) == 3) Console.Write(" ");
}
Console.WriteLine();
}
}
Imports System.IO
Imports System.Security.Cryptography
Public Module HashDirectory
Public Sub Main(ByVal args() As String)
If args.Length < 1 Then
Console.WriteLine("No directory selected")
Return
End If
Dim targetDirectory As String = args(0)
If Directory.Exists(targetDirectory) Then
' Create a DirectoryInfo object representing the specified directory.
Dim dir As New DirectoryInfo(targetDirectory)
' Get the FileInfo objects for every file in the directory.
Dim files As FileInfo() = dir.GetFiles()
' Initialize a SHA256 hash object.
Using mySHA256 As SHA256 = SHA256.Create()
' Compute and print the hash values for each file in directory.
For Each fInfo As FileInfo In files
Try
' Create a fileStream for the file.
Dim fileStream = fInfo.Open(FileMode.Open)
' Be sure it's positioned to the beginning of the stream.
fileStream.Position = 0
' Compute the hash of the fileStream.
Dim hashValue() As Byte = mySHA256.ComputeHash(fileStream)
' Write the name of the file to the Console.
Console.Write(fInfo.Name + ": ")
' Write the hash value to the Console.
PrintByteArray(hashValue)
' Close the file.
fileStream.Close()
Catch e As IOException
Console.WriteLine($"I/O Exception: {e.Message}")
Catch e As UnauthorizedAccessException
Console.WriteLine($"Access Exception: {e.Message}")
End Try
Next
End Using
Else
Console.WriteLine("The directory specified could not be found.")
End If
End Sub
' Print the byte array in a readable format.
Public Sub PrintByteArray(array() As Byte)
For i As Integer = 0 To array.Length - 1
Console.Write($"{array(i):X2}")
If i Mod 4 = 3 Then
Console.Write(" ")
End If
Next
Console.WriteLine()
End Sub
End Module
備註
雜湊值作為固定大小的唯一值，代表大量資料。 兩組資料的雜湊值應匹配，當且僅當對應的資料也相符。 資料中的小變動會導致雜湊值大幅且不可預測地變化。
該 SHA256 演算法的雜湊大小為 256 位元。
這是抽象類。
建構函式
| 名稱 | Description |
|---|---|
| SHA256() |
初始化 SHA256 的新執行個體。 |
欄位
| 名稱 | Description |
|---|---|
| HashSizeInBits |
SHA-256 演算法產生的雜湊大小，單位為位元。 |
| HashSizeInBytes |
SHA-256 演算法產生的雜湊大小，以位元組為單位。 |
| HashSizeValue |
代表計算出的雜湊碼大小（以位元為單位）。 (繼承來源 HashAlgorithm) |
| HashValue |
代表計算出的雜湊碼值。 (繼承來源 HashAlgorithm) |
| State |
代表雜湊計算的狀態。 (繼承來源 HashAlgorithm) |
屬性
| 名稱 | Description |
|---|---|
| CanReuseTransform |
會得到一個值，表示電流轉換是否可以重複使用。 (繼承來源 HashAlgorithm) |
| CanTransformMultipleBlocks |
當在派生類別中覆寫時，會得到一個值，表示是否可以轉換多個區塊。 (繼承來源 HashAlgorithm) |
| Hash |
取得計算出的雜湊碼值。 (繼承來源 HashAlgorithm) |
| HashSize |
取得計算出的雜湊碼大小（以位元為單位）。 (繼承來源 HashAlgorithm) |
| InputBlockSize |
當在衍生類別中覆寫時，會得到輸入區塊大小。 (繼承來源 HashAlgorithm) |
| OutputBlockSize |
當在衍生類別中覆寫時，會得到輸出區塊大小。 (繼承來源 HashAlgorithm) |
方法
明確介面實作
| 名稱 | Description |
|---|---|
| IDisposable.Dispose() |
釋放 未管理的資源， HashAlgorithm 並可選擇性地釋放受管理資源。 (繼承來源 HashAlgorithm) |
