RandomNumberGenerator.GetNonZeroBytes Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
| 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. |
- 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[] -> unitabstract member GetNonZeroBytes : byte[] -> unitPublic 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
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- 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> -> unitPublic Overridable Sub GetNonZeroBytes (data As Span(Of Byte))Parameters
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Standard | 2.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: