SHA256 Clase

Definición

Espacio de nombres:

System.Security.Cryptography

Ensamblado:

System.Security.Cryptography.dll

Source:

SHA256.cs

Calcula el valor hash de SHA256 para los datos de entrada.

C#

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

Herencia

Object

HashAlgorithm

SHA256

Derivado

System.Security.Cryptography.SHA256Cng

System.Security.Cryptography.SHA256CryptoServiceProvider

System.Security.Cryptography.SHA256Managed

Ejemplos

En el ejemplo siguiente se calcula el hash SHA-256 para todos los archivos de un directorio.

C#

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();
    }
}

Comentarios

El hash se usa como un valor único de tamaño fijo que representa una gran cantidad de datos. Los hashes de dos conjuntos de datos deben coincidir si y solo si los datos correspondientes también coinciden. Los pequeños cambios en los datos dan lugar a cambios impredecibles grandes en el hash.

El tamaño hash del SHA256 algoritmo es de 256 bits.

Esta es una clase abstracta.

Constructores

SHA256()

Inicializa una nueva instancia de la clase SHA256.

Campos

HashSizeInBits	Tamaño hash generado por el algoritmo SHA256, en bits.
HashSizeInBytes	Tamaño hash generado por el algoritmo SHA256, en bytes.
HashSizeValue	Representa el tamaño en bits del código hash calculado. (Heredado de HashAlgorithm)
HashValue	Representa el valor del código hash calculado. (Heredado de HashAlgorithm)
State	Representa el estado del cálculo del valor hash. (Heredado de HashAlgorithm)

Propiedades

CanReuseTransform	Obtiene un valor que indica si la transformación actual puede volver a usarse. (Heredado de HashAlgorithm)
CanTransformMultipleBlocks	Cuando se invalida en una clase derivada, obtiene un valor que indica si se pueden transformar varios bloques. (Heredado de HashAlgorithm)
Hash	Obtiene el valor del código hash calculado. (Heredado de HashAlgorithm)
HashSize	Obtiene el tamaño en bits del código hash calculado. (Heredado de HashAlgorithm)
InputBlockSize	Cuando se invalida en una clase derivada, obtiene el tamaño del bloque de entrada. (Heredado de HashAlgorithm)
OutputBlockSize	Cuando se invalida en una clase derivada, obtiene el tamaño del bloque de salida. (Heredado de HashAlgorithm)

Métodos

Clear()	Libera todos los recursos que utiliza la clase HashAlgorithm. (Heredado de HashAlgorithm)
ComputeHash(Byte[])	Calcula el valor hash para la matriz de bytes especificada. (Heredado de HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)	Calcula el valor hash para la región especificada de la matriz de bytes indicada. (Heredado de HashAlgorithm)
ComputeHash(Stream)	Calcula el valor hash del objeto Stream especificado. (Heredado de HashAlgorithm)
ComputeHashAsync(Stream, CancellationToken)	Calcula de manera asincrónica el valor hash del objeto Stream especificado. (Heredado de HashAlgorithm)
Create()	Crea una instancia de la implementación predeterminada de SHA256.
Create(String)	Obsoletos. Crea una instancia de la implementación de SHA256 especificada.
Dispose()	Libera todos los recursos usados por la instancia actual de la clase HashAlgorithm. (Heredado de HashAlgorithm)
Dispose(Boolean)	Libera los recursos no administrados que usa HashAlgorithm y, de forma opcional, libera los recursos administrados. (Heredado de HashAlgorithm)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HashCore(Byte[], Int32, Int32)	Cuando se invalida en una clase derivada, enruta los datos escritos en el objeto al algoritmo hash para el cálculo del valor hash. (Heredado de HashAlgorithm)
HashCore(ReadOnlySpan<Byte>)	Envía los datos escritos en el objeto al algoritmo hash para el cálculo del valor hash. (Heredado de HashAlgorithm)
HashData(Byte[])	Calcula el hash de los datos con el algoritmo SHA256.
HashData(ReadOnlySpan<Byte>)	Calcula el hash de los datos con el algoritmo SHA256.
HashData(ReadOnlySpan<Byte>, Span<Byte>)	Calcula el hash de los datos con el algoritmo SHA256.
HashData(Stream)	Calcula el hash de una secuencia mediante el algoritmo SHA256.
HashData(Stream, Span<Byte>)	Calcula el hash de una secuencia mediante el algoritmo SHA256.
HashDataAsync(Stream, CancellationToken)	Calcula asincrónicamente el hash de una secuencia mediante el algoritmo SHA256.
HashDataAsync(Stream, Memory<Byte>, CancellationToken)	Calcula asincrónicamente el hash de una secuencia mediante el algoritmo SHA256.
HashFinal()	Cuando se invalida en una clase derivada, finaliza el cálculo de hash una vez que el algoritmo hash criptográfico termina de procesar los últimos datos. (Heredado de HashAlgorithm)
Initialize()	Restablece el algoritmo hash a su estado inicial. (Heredado de HashAlgorithm)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	Calcula el valor hash para la región especificada de la matriz de bytes de entrada y copia la región especificada de la matriz de bytes de entrada resultante en la región indicada de la matriz de bytes de salida. (Heredado de HashAlgorithm)
TransformFinalBlock(Byte[], Int32, Int32)	Calcula el valor hash para la región especificada de la matriz de bytes indicada. (Heredado de HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Intenta calcular el valor de hash para la matriz de bytes especificada. (Heredado de HashAlgorithm)
TryHashData(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Intenta calcular el hash de los datos mediante el algoritmo SHA256.
TryHashFinal(Span<Byte>, Int32)	Intenta finalizar el cálculo de hash una vez que el algoritmo hash procesa los últimos datos. (Heredado de HashAlgorithm)

Se aplica a

Consulte también

• servicios criptográficos