HashAlgorithm.TransformFinalBlock(Byte[], Int32, Int32) Méthode

Définition

Espace de noms:

System.Security.Cryptography

Assemblys:

netstandard.dll, System.Security.Cryptography.dll

Source:

HashAlgorithm.cs

Calcule la valeur de hachage pour la région spécifiée du tableau d'octets spécifié.

C#

public byte[] TransformFinalBlock(byte[] inputBuffer, int inputOffset, int inputCount);

Paramètres

inputBuffer

Byte[]

Entrée pour laquelle le code de hachage doit être calculé.

inputOffset

Int32

Offset dans le tableau d'octets à partir duquel l'utilisation de données commence.

inputCount

Int32

Nombre d'octets dans le tableau d'octets à utiliser comme données.

Retours

Byte[]

Tableau qui est une copie de la partie de l'entrée qui est hachée.

Implémente

TransformFinalBlock(Byte[], Int32, Int32)

Exceptions

ArgumentException

inputCount utilise une valeur non valide.

- ou -

inputBuffer a une longueur d'offset non valide.

ArgumentNullException

inputBuffer a la valeur null.

ArgumentOutOfRangeException

inputOffset est hors limites. Ce paramètre requiert un nombre non négatif.

ObjectDisposedException

L'objet a déjà été supprimé.

Exemples

Les exemples de code suivants utilisent la TransformFinalBlock méthode avec la TransformBlock méthode pour hacher une chaîne.

C#

using System;
using System.Security.Cryptography;
using System.Text;

class MainClass
{
    public static void Main()
    {
        RandomNumberGenerator rnd = RandomNumberGenerator.Create();

        byte[] input = new byte[20];
        rnd.GetBytes(input);

        Console.WriteLine("Input        : {0}\n", BytesToStr(input));
        PrintHash(input);
        PrintHashOneBlock(input);
        PrintHashMultiBlock(input, 1);
        PrintHashMultiBlock(input, 2);
        PrintHashMultiBlock(input, 3);
        PrintHashMultiBlock(input, 5);
        PrintHashMultiBlock(input, 10);
        PrintHashMultiBlock(input, 11);
        PrintHashMultiBlock(input, 19);
        PrintHashMultiBlock(input, 20);
        PrintHashMultiBlock(input, 21);
    }

    public static string BytesToStr(byte[] bytes)
    {
        StringBuilder str = new StringBuilder();

        for (int i = 0; i < bytes.Length; i++)
            str.AppendFormat("{0:X2}", bytes[i]);

        return str.ToString();
    }

    public static void PrintHash(byte[] input)
    {
        SHA256Managed sha = new SHA256Managed();
        Console.WriteLine("ComputeHash  : {0}", BytesToStr(sha.ComputeHash(input)));
    }

    public static void PrintHashOneBlock(byte[] input)
    {
        SHA256Managed sha = new SHA256Managed();
        sha.TransformFinalBlock(input, 0, input.Length);
        Console.WriteLine("FinalBlock   : {0}", BytesToStr(sha.Hash));
    }

    public static void PrintHashMultiBlock(byte[] input, int size)
    {
        SHA256Managed sha = new SHA256Managed();
        int offset = 0;

        while (input.Length - offset >= size)
            offset += sha.TransformBlock(input, offset, size, input, offset);

        sha.TransformFinalBlock(input, offset, input.Length - offset);
        Console.WriteLine("MultiBlock {0:00}: {1}", size, BytesToStr(sha.Hash));
    }
}
/*
This example produces output similar to the following:

Input        : 45D97219908A572DE336B9DEC787C311D3349F69

ComputeHash  : 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
FinalBlock   : 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 01: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 02: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 03: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 05: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 10: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 11: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 19: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 20: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15
MultiBlock 21: 84E87322C7E3BCA848B0A698EE66E9A9725DA786F9FD4FFD46C385F59AB35B15

*/

Remarques

Vous devez appeler la TransformFinalBlock méthode après l’appel de la TransformBlock méthode, mais avant de récupérer la valeur de hachage finale.

Notez que la valeur de retour de cette méthode n’est pas la valeur de hachage, mais seulement une copie de la partie hachée des données d’entrée. Pour récupérer la valeur de hachage finale après l’appel de la TransformFinalBlock méthode, récupérez le tableau d’octets contenu dans la Hash propriété .

S’applique à