Random.NextBytes Método

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.Extensions.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
NextBytes(Byte[])

Preenche os elementos de um array especificado de bytes com números aleatórios.
NextBytes(Span<Byte>)

Preenche os elementos de um intervalo especificado de bytes com números aleatórios.

NextBytes(Byte[])

Origem:
Random.cs
Origem:
Random.cs
Origem:
Random.cs
Origem:
Random.cs
Origem:
Random.cs

Preenche os elementos de um array especificado de bytes com números aleatórios.

public:
 virtual void NextBytes(cli::array <System::Byte> ^ buffer);
public virtual void NextBytes(byte[] buffer);
abstract member NextBytes : byte[] -> unit
override this.NextBytes : byte[] -> unit
Public Overridable Sub NextBytes (buffer As Byte())

Parâmetros

buffer
Byte[]

O array deve ser preenchido com números aleatórios.

Exceções

ArgumentNullException

buffer é null.

Exemplos

O exemplo seguinte demonstra como usar o NextBytes método para preencher um array de bytes com valores aleatórios de bytes.

Random rnd = new Random();
Byte[] b = new Byte[10];
rnd.NextBytes(b);
Console.WriteLine("The Random bytes are: ");
for (int i = 0; i <= b.GetUpperBound(0); i++)
    Console.WriteLine("{0}: {1}", i, b[i]);

// The example displays output similar to the following:
//       The Random bytes are:
//       0: 131
//       1: 96
//       2: 226
//       3: 213
//       4: 176
//       5: 208
//       6: 99
//       7: 89
//       8: 226
//       9: 194

Public Class Example
    Public Shared Sub Main()
        Dim rnd As New Random()
        Dim b(9) As Byte
        rnd.NextBytes(b)
        Console.WriteLine("The Random bytes are: ")
        For i As Integer = 0 To b.GetUpperBound(0)
            Console.WriteLine("{0}: {1}", i, b(i))
        Next
    End Sub 
End Class 
' The example displays output similar to the following:
'       The Random bytes are:
'       0: 131
'       1: 96
'       2: 226
'       3: 213
'       4: 176
'       5: 208
'       6: 99
'       7: 89
'       8: 226
'       9: 194

Observações

Cada elemento do array de bytes é definido para um número aleatório maior ou igual a 0, e menor ou igual a MaxValue.

Por exemplo, para gerar um número aleatório criptograficamente seguro adequado para criar uma palavra-passe aleatória, use um método como RNGCryptoServiceProvider.GetBytes.

Notas para Herdeiros

A partir da versão 2.0 do .NET Framework, se derivar uma classe a partir de Random e sobrescrever o método Sample(), a distribuição fornecida pela implementação de classe derivada do método Sample() não é usada nas chamadas para a implementação da classe base do método NextBytes(Byte[]). Em vez disso, utiliza-se a distribuição uniforme devolvida pela classe base Random . Este comportamento melhora o desempenho geral da Random turma. Para modificar este comportamento e chamar o Sample() método na classe derivada, também deve sobrescrever o NextBytes(Byte[]) método.

Ver também

Aplica-se a

NextBytes(Span<Byte>)

Origem:
Random.cs
Origem:
Random.cs
Origem:
Random.cs
Origem:
Random.cs
Origem:
Random.cs

Preenche os elementos de um intervalo especificado de bytes com números aleatórios.

public:
 virtual void NextBytes(Span<System::Byte> buffer);
public virtual void NextBytes(Span<byte> buffer);
abstract member NextBytes : Span<byte> -> unit
override this.NextBytes : Span<byte> -> unit
Public Overridable Sub NextBytes (buffer As Span(Of Byte))

Parâmetros

buffer
Span<Byte>

O array deve ser preenchido com números aleatórios.

Observações

Cada elemento do intervalo de bytes é definido para um número aleatório maior ou igual a 0 e menor ou igual a MaxValue.

Aplica-se a