SHA256 Klasse

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Quelle:

SHA256.cs

Berechnet den SHA256-Hash für die Eingabedaten.

public ref class SHA256 abstract : System::Security::Cryptography::HashAlgorithm

public abstract class SHA256 : System.Security.Cryptography.HashAlgorithm

type SHA256 = class
    inherit HashAlgorithm

Public MustInherit Class SHA256
Inherits HashAlgorithm

Vererbung

Object

HashAlgorithm

SHA256

Abgeleitet

System.Security.Cryptography.SHA256Cng

System.Security.Cryptography.SHA256CryptoServiceProvider

System.Security.Cryptography.SHA256Managed

Beispiele

Im folgenden Beispiel wird der SHA-256-Hash für alle Dateien in einem Verzeichnis berechnet.

using namespace System;
using namespace System::IO;
using namespace System::Security::Cryptography;

// Print the byte array in a readable format.
void PrintByteArray( array<Byte>^array )
{
   int i;
   for ( i = 0; i < array->Length; i++ )
   {
      Console::Write( String::Format( "{0:X2}", array[ i ] ) );
      if ( (i % 4) == 3 )
            Console::Write( " " );

   }
   Console::WriteLine();
}

int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   if ( args->Length < 2 )
   {
      Console::WriteLine( "Usage: hashdir <directory>" );
      return 0;
   }

   try
   {

      // Create a DirectoryInfo object representing the specified directory.
      DirectoryInfo^ dir = gcnew DirectoryInfo( args[ 1 ] );

      // Get the FileInfo objects for every file in the directory.
      array<FileInfo^>^files = dir->GetFiles();

      // Initialize a SHA256 hash object.
      SHA256 ^ mySHA256 = SHA256Managed::Create();
      array<Byte>^hashValue;

      // Compute and print the hash values for each file in directory.
      System::Collections::IEnumerator^ myEnum = files->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         FileInfo^ fInfo = safe_cast<FileInfo^>(myEnum->Current);

         // Create a fileStream for the file.
         FileStream^ fileStream = fInfo->Open( FileMode::Open );

         // Compute the hash of the fileStream.
         hashValue = mySHA256->ComputeHash( fileStream );

         // Write the name of the file to the Console.
         Console::Write( "{0}: ", fInfo->Name );

         // Write the hash value to the Console.
         PrintByteArray( hashValue );

         // Close the file.
         fileStream->Close();
      }
      return 0;
   }
   catch ( DirectoryNotFoundException^ ) 
   {
      Console::WriteLine( "Error: The directory specified could not be found." );
   }
   catch ( IOException^ ) 
   {
      Console::WriteLine( "Error: A file in the directory could not be accessed." );
   }

}

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

Hinweise

Der Hash wird als eindeutiger Wert mit fester Größe verwendet, der eine große Datenmenge darstellt. Hashes von zwei Datensätzen sollten nur übereinstimmen, wenn die entsprechenden Daten ebenfalls übereinstimmen. Kleine Änderungen an den Daten führen zu großen unvorhersehbaren Änderungen im Hash.

Die Hashgröße für den SHA256 Algorithmus beträgt 256 Bits.

Dies ist eine abstrakte Klasse.

Konstruktoren

SHA256()

Initialisiert eine neue Instanz von SHA256.

Felder

HashSizeInBits	Die vom SHA256-Algorithmus erzeugte Hashgröße in Bits.
HashSizeInBytes	Die vom SHA256-Algorithmus erzeugte Hashgröße in Bytes.
HashSizeValue	Stellt die Größe des berechneten Hashcodes in Bits dar. (Geerbt von HashAlgorithm)
HashValue	Stellt den Wert des errechneten Hashcodes dar. (Geerbt von HashAlgorithm)
State	Stellt den Zustand der Hashberechnung dar. (Geerbt von HashAlgorithm)

Eigenschaften

CanReuseTransform	Ruft einen Wert ab, der angibt, ob die aktuelle Transformation wiederverwendet werden kann. (Geerbt von HashAlgorithm)
CanTransformMultipleBlocks	Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob mehrere Blöcke transformiert werden können. (Geerbt von HashAlgorithm)
Hash	Ruft den Wert des berechneten Hashcodes ab. (Geerbt von HashAlgorithm)
HashSize	Ruft die Größe des berechneten Hashcodes in Bits ab. (Geerbt von HashAlgorithm)
InputBlockSize	Ruft beim Überschreiben in einer abgeleiteten Klasse die Eingabeblockgröße ab. (Geerbt von HashAlgorithm)
OutputBlockSize	Ruft beim Überschreiben in einer abgeleiteten Klasse die Ausgabeblockgröße ab. (Geerbt von HashAlgorithm)

Methoden

Clear()	Gibt alle von der HashAlgorithm-Klasse verwendeten Ressourcen frei. (Geerbt von HashAlgorithm)
ComputeHash(Byte[])	Errechnet den Hashwert für das angegebene Bytearray. (Geerbt von HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)	Berechnet den Hashwert für den angegebenen Bereich des angegebenen Bytearrays. (Geerbt von HashAlgorithm)
ComputeHash(Stream)	Berechnet den Hashwert für das angegebene Stream-Objekt. (Geerbt von HashAlgorithm)
ComputeHashAsync(Stream, CancellationToken)	Berechnet den Hashwert für das angegebene Stream-Objekt asynchron. (Geerbt von HashAlgorithm)
Create()	Erstellt eine Instanz der Standardimplementierung von SHA256.
Create(String)	Veraltet. Erstellt eine Instanz einer angegebenen Implementierung von SHA256.
Dispose()	Gibt alle von der aktuellen Instanz der HashAlgorithm-Klasse verwendeten Ressourcen frei. (Geerbt von HashAlgorithm)
Dispose(Boolean)	Gibt die von HashAlgorithm verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von HashAlgorithm)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HashCore(Byte[], Int32, Int32)	Leitet beim Überschreiben in einer abgeleiteten Klasse die in das Objekt geschriebenen Daten zum Errechnen des Hashs an den Hashalgorithmus weiter. (Geerbt von HashAlgorithm)
HashCore(ReadOnlySpan<Byte>)	Leitet die in das Objekt geschriebenen Daten zum Berechnen des Hashs in den Hashalgorithmus weiter. (Geerbt von HashAlgorithm)
HashData(Byte[])	Berechnet den Datenhash mithilfe des SHA256-Algorithmus.
HashData(ReadOnlySpan<Byte>)	Berechnet den Datenhash mithilfe des SHA256-Algorithmus.
HashData(ReadOnlySpan<Byte>, Span<Byte>)	Berechnet den Datenhash mithilfe des SHA256-Algorithmus.
HashData(Stream)	Berechnet den Hash eines Streams mithilfe des SHA256-Algorithmus.
HashData(Stream, Span<Byte>)	Berechnet den Hash eines Streams mithilfe des SHA256-Algorithmus.
HashDataAsync(Stream, CancellationToken)	Berechnet asynchron den Hash eines Streams mithilfe des SHA256-Algorithmus.
HashDataAsync(Stream, Memory<Byte>, CancellationToken)	Berechnet asynchron den Hash eines Streams mithilfe des SHA256-Algorithmus.
HashFinal()	Schließt beim Überschreiben in einer abgeleiteten Klasse die Berechnung des Hashs ab, nachdem die letzten Daten vom kryptografischen Hashalgorithmus verarbeitet wurden. (Geerbt von HashAlgorithm)
Initialize()	Setzt den Hashalgorithmus auf seinen ursprünglichen Zustand zurück. (Geerbt von HashAlgorithm)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	Errechnet den Hashwert für den angegebenen Bereich des Eingabebytearrays und kopiert den angegebenen Bereich des Eingabebytearrays in den angegebenen Bereich des Ausgabebytearrays. (Geerbt von HashAlgorithm)
TransformFinalBlock(Byte[], Int32, Int32)	Berechnet den Hashwert für den angegebenen Bereich des angegebenen Bytearrays. (Geerbt von HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Versucht, den Hashwert für das angegebene Bytearray zu berechnen. (Geerbt von HashAlgorithm)
TryHashData(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Versucht, den Datenhash mithilfe des SHA256-Algorithmus zu berechnen.
TryHashFinal(Span<Byte>, Int32)	Versucht, die Hashberechnung abzuschließen, nachdem die letzten Daten vom Hashalgorithmus verarbeitet wurden. (Geerbt von HashAlgorithm)

Weitere Informationen

• Kryptografische Dienste