RandomNumberGenerator.GetNonZeroBytes Method

Definition

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
Source:
RandomNumberGenerator.cs
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:
 abstract void GetNonZeroBytes(cli::array <System::Byte> ^ data);
public virtual void GetNonZeroBytes (byte[] data);
public abstract void GetNonZeroBytes (byte[] data);
abstract member GetNonZeroBytes : byte[] -> unit
override this.GetNonZeroBytes : byte[] -> unit
abstract member GetNonZeroBytes : byte[] -> unit
Public Overridable Sub GetNonZeroBytes (data As Byte())
Public MustOverride 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

Applies to

GetNonZeroBytes(Span<Byte>)

Source:
RandomNumberGenerator.cs
Source:
RandomNumberGenerator.cs
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.

Applies to