SHA256Managed Clase

Definición

Espacio de nombres:

System.Security.Cryptography

Ensamblado:

System.Security.Cryptography.dll

Source:

SHA256Managed.cs

Precaución

Derived cryptographic types are obsolete. Use the Create method on the base type instead.

Calcula el valor hash de SHA256 de los datos de entrada utilizando la biblioteca administrada.

public ref class SHA256Managed sealed : System::Security::Cryptography::SHA256

[System.Obsolete("Derived cryptographic types are obsolete. Use the Create method on the base type instead.", DiagnosticId="SYSLIB0021", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class SHA256Managed : System.Security.Cryptography.SHA256

[<System.Obsolete("Derived cryptographic types are obsolete. Use the Create method on the base type instead.", DiagnosticId="SYSLIB0021", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type SHA256Managed = class
    inherit SHA256

Public NotInheritable Class SHA256Managed
Inherits SHA256

Herencia

Object

HashAlgorithm

SHA256

SHA256Managed

Atributos

ObsoleteAttribute

Ejemplos

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

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

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 SHA256Managed algoritmo es de 256 bits.

Constructores

SHA256Managed()

Obsoletos. Inicializa una nueva instancia de la clase SHA256Managed utilizando la biblioteca administrada.

Campos

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

Propiedades

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

Métodos

Clear()	Obsoletos. Libera todos los recursos que utiliza la clase HashAlgorithm. (Heredado de HashAlgorithm)
ComputeHash(Byte[])	Obsoletos. Calcula el valor hash para la matriz de bytes especificada. (Heredado de HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)	Obsoletos. Calcula el valor hash para la región especificada de la matriz de bytes indicada. (Heredado de HashAlgorithm)
ComputeHash(Stream)	Obsoletos. Calcula el valor hash del objeto Stream especificado. (Heredado de HashAlgorithm)
ComputeHashAsync(Stream, CancellationToken)	Obsoletos. Calcula de manera asincrónica el valor hash del objeto Stream especificado. (Heredado de HashAlgorithm)
Dispose()	Obsoletos. Libera todos los recursos usados por la instancia actual de la clase HashAlgorithm. (Heredado de HashAlgorithm)
Dispose(Boolean)	Obsoletos. Libera los recursos no administrados que usa HashAlgorithm y, de forma opcional, libera los recursos administrados. (Heredado de HashAlgorithm)
Equals(Object)	Obsoletos. Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Obsoletos. Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obsoletos. Obtiene el Type de la instancia actual. (Heredado de Object)
HashCore(Byte[], Int32, Int32)	Obsoletos. 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>)	Obsoletos. Envía los datos escritos en el objeto al algoritmo hash para el cálculo del valor hash. (Heredado de HashAlgorithm)
HashFinal()	Obsoletos. 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()	Obsoletos. Inicializa una instancia de SHA256Managed.
MemberwiseClone()	Obsoletos. Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Obsoletos. Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	Obsoletos. 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)	Obsoletos. Calcula el valor hash para la región especificada de la matriz de bytes indicada. (Heredado de HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Obsoletos. Intenta calcular el valor de hash para la matriz de bytes especificada. (Heredado de HashAlgorithm)
TryHashFinal(Span<Byte>, Int32)	Obsoletos. Intenta finalizar el cálculo de hash una vez que el algoritmo hash procesa los últimos datos. (Heredado de HashAlgorithm)

Consulte también

• servicios criptográficos