SHA-224 - NCiphers

This chapter illustrates how to create SHA-224 hashing in C# and VB.NET using the NCiphers.Crypto library.

SHA-224 is not very commonly used, because of its output which is 224 bit long (28 bytes) and doesn’t align with the common 8 byte aligned machine word length.

Table of contents

1. Digest output
2. digest from a byte array
3. digest from a String
4. digest from a file
5. digest from a Stream

1. Digest output

The raw digest output from a hash function is a byte array constructed by computing the hash algorithm over the input data:

C# example

byte[] hash = NCiphers.Hashing.HashTools.Sha224(data);

VB.NET example

 
Dim hash As Byte() = NCiphers.Hashing.HashTools.Sha224(data)

There may be cases when we need the digest to be received as a String from the hexadecimal representation of the hash bytes. In that case we shall use:

C# example

byte[] hash = NCiphers.Hashing.HashTools.Sha224Hex(data);

VB.NET example

Dim hash As Byte() = NCiphers.Hashing.HashTools.Sha224Hex(data)

Back to ToC

2. Sha224 from a byte array

Here is how to compute the Sha224 message digest of a byte array:

C# example

byte[] data = new byte[] {1,2,3,4,5,6,7,8,9,100,200,300,400,500};
byte[] hash = NCiphers.Hashing.HashTools.Sha224(data);
string hashAsString = NCiphers.Hashing.HashTools.Sha224Hex(data);

VB.NET example

Dim data As New Byte() {1,2,3,4,5,6,7,8,9,100,200,300,400,500}
Dim hash As Byte() = NCiphers.Hashing.HashTools.Sha224(data)
Dim hashAsString As String = NCiphers.Hashing.HashTools.Sha224Hex(data)

Back to ToC

3. Sha224 from a String

Getting the Sha224 hash of a String is similar to the above example:

C# example

string data = "Hello World";
byte[] hash = NCiphers.Hashing.HashTools.Sha224(data);
string hashAsString = NCiphers.Hashing.HashTools.Sha224Hex(data);

VB.NET example

Dim data As String = "Hello World"
Dim hash As Byte() = NCiphers.Hashing.HashTools.Sha224(data)
Dim hashAsString As String = NCiphers.Hashing.HashTools.Sha224Hex(data)

Back to ToC

4. Sha224 from a file

To get the Sha224 hash of a file, we simply supply a System.IO.FileInfo object as parameter:

C# example

System.IO.FileInfo data = new System.IO.FileInfo(@"c:\myfile.txt");
byte[] hash = NCiphers.Hashing.HashTools.Sha224(data);
string hashAsString = NCiphers.Hashing.HashTools.Sha224Hex(data);

VB.NET example

Dim data As New System.IO.FileInfo("c:\myfile.txt")
Dim hash As Byte() = NCiphers.Hashing.HashTools.Sha224(data)
Dim hashAsString As String = NCiphers.Hashing.HashTools.Sha224Hex(data)

Back to ToC

5. Sha224 from a Stream

The overloaded methods that accept System.IO.Stream parameter, are reading the input byte by byte and compute the Sha224 digest over this data. Of course the caller must ensure that the Stream is positioned at the start of the data and after the method call its position will be at the end of the Stream. It is also the obligation of the caller to close the Stream.

C# example

byte[] bytes = new byte[] {1,2,3,4,5,6,7,8,9,100,200,300,400,500};
System.IO.Stream data = new MemoryStream(bytes);
byte[] hash = NCiphers.Hashing.HashTools.Sha224(data);
string hashAsString = NCiphers.Hashing.HashTools.Sha224Hex(data);

VB.NET example

Dim bytes As New Byte() {1,2,3,4,5,6,7,8,9,100,200,300,400,500}
Dim data As New System.IO.MemoryStream(bytes)
Dim hash As Byte() = NCiphers.Hashing.HashTools.Sha224(data)
Dim hashAsString As String = NCiphers.Hashing.HashTools.Sha224Hex(data)

Back to ToC

6. Summary

This article demonstrated how to compute Sha224 message digest hashes with the NCiphers.Crypto library. Probably you may be interested to see also the other hash functions offered by the library.

List of methods used:

NCiphers.Hashing.HashTools.Sha224 – returns the Sha224 hash as byte array
NCiphers.Hashing.HashTools.Sha224Hex – returns the Sha224 hash as hexadecimal String