HashAlgorithm.TransformBlock(Byte[], Int32, Int32, Byte[], Int32) メソッド

定義

名前空間:

System.Security.Cryptography

アセンブリ:

netstandard.dll, System.Security.Cryptography.dll

ソース:

HashAlgorithm.cs

入力バイト配列の指定した領域のハッシュ値を計算し、入力バイト配列の指定した領域を出力バイト配列の指定した領域にコピーします。

C#

public int TransformBlock(byte[] inputBuffer, int inputOffset, int inputCount, byte[]? outputBuffer, int outputOffset);

パラメーター

inputBuffer

Byte[]

ハッシュ コードを計算する対象の入力データ。

inputOffset

Int32

入力バイト配列内のデータの使用開始位置を示すオフセット。

inputCount

Int32

データとして使用する入力バイト配列内のバイト数。

outputBuffer

Byte[]

ハッシュ コードの計算に使用される入力配列の一部のコピー。

outputOffset

Int32

データの書き込みの開始位置を示す出力バイト配列内のオフセット。

戻り値

Int32

書き込まれたバイト数。

実装

TransformBlock(Byte[], Int32, Int32, Byte[], Int32)

例外

ArgumentException

inputCount が無効な値を使用しています。

または

inputBuffer の長さが無効です。

ArgumentNullException

inputBuffer が nullです。

ArgumentOutOfRangeException

inputOffset が範囲外です。 このパラメーターには、負数以外を指定する必要があります。

ObjectDisposedException

オブジェクトは既には帰されています。

例

次のコード例では、 メソッドと メソッドをTransformFinalBlockTransformBlock使用して文字列をハッシュします。

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

*/

注釈

メソッドを呼び出す前に、 TransformBlock メソッドを TransformFinalBlock 呼び出す必要があります。 最終的なハッシュ値を取得する前に、両方のメソッドを呼び出す必要があります。

メソッドの呼び出し後に最終的なハッシュ値を TransformFinalBlock 取得するには、 プロパティに含まれるバイト配列を Hash 取得します。

TransformBlock異なる入力配列と出力配列を使用して メソッドを呼び出すと、 が発生しますIOException。

適用対象