RandomNumberGenerator.GetNonZeroBytes Method

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Overloads

GetNonZeroBytes(Byte[])	When overridden in a derived class, fills an array of bytes with a cryptographically strong random sequence of nonzero values.
GetNonZeroBytes(Span<Byte>)	Fills a byte span with a cryptographically strong random sequence of nonzero values.

GetNonZeroBytes(Byte[])

Source:

RandomNumberGenerator.cs

When overridden in a derived class, fills an array of bytes with a cryptographically strong random sequence of nonzero values.

public:
 virtual void GetNonZeroBytes(cli::array <System::Byte> ^ data);

public virtual void GetNonZeroBytes (byte[] data);

abstract member GetNonZeroBytes : byte[] -> unit
override this.GetNonZeroBytes : byte[] -> unit

Public Overridable Sub GetNonZeroBytes (data As Byte())

Parameters

data

Byte[]

The array to fill with cryptographically strong random nonzero bytes.

Examples

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

array<Byte>^ random = gcnew array<Byte>(100);
RandomNumberGenerator^ rng = RandomNumberGenerator::Create();
rng->GetNonZeroBytes( random ); // The array is now filled with cryptographically strong random bytes, and none are zero.

byte[] random = new byte[100];

using (RandomNumberGenerator rng = RandomNumberGenerator.Create())
{
    rng.GetNonZeroBytes(random); // The array is now filled with cryptographically strong random bytes, and none are zero.
}

Dim random() As Byte = New Byte(100) {}

Using rng As RandomNumberGenerator = RandomNumberGenerator.Create()
    rng.GetNonZeroBytes(random) ' bytes in random are now random and none are zero
End Using

Remarks

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

See also

• Cryptographic Services

GetNonZeroBytes(Span<Byte>)

Source:

RandomNumberGenerator.cs

Fills a byte span with a cryptographically strong random sequence of nonzero values.

public:
 virtual void GetNonZeroBytes(Span<System::Byte> data);

public virtual void GetNonZeroBytes (Span<byte> data);

abstract member GetNonZeroBytes : Span<byte> -> unit
override this.GetNonZeroBytes : Span<byte> -> unit

Public Overridable Sub GetNonZeroBytes (data As Span(Of Byte))

Parameters

data

Span<Byte>

The span to fill with cryptographically strong random nonzero bytes.