Export (0) Print
Expand All

RNGCryptoServiceProvider.GetNonZeroBytes Method

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

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

'Declaration
Public Overrides Sub GetNonZeroBytes ( _
	data As Byte() _
)

Parameters

data
Type: System.Byte()

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

ExceptionCondition
CryptographicException

The cryptographic service provider (CSP) cannot be acquired.

ArgumentNullException

data is Nothing.

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.

Dim random() As Byte = New Byte(100) {}
'RNGCryptoServiceProvider is an implementation of an RNG 
Dim rng As New RNGCryptoServiceProvider()
rng.GetNonZeroBytes(random) ' bytes in random are now random and none are zero

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft