RNGCryptoServiceProvider::GetNonZeroBytes Method (array<Byte>^)

 

Fills an array of bytes with a cryptographically strong sequence of random nonzero values.

Namespace:   System.Security.Cryptography
Assembly:  mscorlib (in mscorlib.dll)

public:
virtual void GetNonZeroBytes(
	array<unsigned char>^ data
) override

Parameters

data
Type: array<System::Byte>^

The array to fill with a cryptographically strong sequence of random nonzero values.

Exception Condition
CryptographicException

The cryptographic service provider (CSP) cannot be acquired.

ArgumentNullException

data is null.

The length of the byte array determines how many cryptographically strong random nonzero bytes are produced.

The following code example creates a random sequence of 100 nonzero bytes and stores it in random.

array<Byte>^ random = gcnew array<Byte>(100);
//RNGCryptoServiceProvider is an implementation of a random number generator.
RNGCryptoServiceProvider^ rng = gcnew RNGCryptoServiceProvider;
rng->GetNonZeroBytes( random ); // The array is now filled with cryptographically strong random bytes, and none are zero.

.NET Framework
Available since 1.1
Return to top
Show: