Random.NextBytes Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Surcharges

Nom	Description
NextBytes(Byte[])	Remplit les éléments d’un tableau d’octets spécifié avec des nombres aléatoires.
NextBytes(Span<Byte>)	Remplit les éléments d’une étendue d’octets spécifiée avec des nombres aléatoires.

NextBytes(Byte[])

Source:

Random.cs

Remplit les éléments d’un tableau d’octets spécifié avec des nombres aléatoires.

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())

Paramètres

buffer

Byte[]

Tableau à remplir avec des nombres aléatoires.

Exceptions

ArgumentNullException

buffer a la valeur null.

Exemples

L’exemple suivant montre comment utiliser la NextBytes méthode pour remplir un tableau d’octets avec des valeurs d’octets aléatoires.

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

Remarques

Chaque élément du tableau d’octets est défini sur un nombre aléatoire supérieur ou égal à 0, et inférieur ou égal à MaxValue.

Par exemple, pour générer un nombre aléatoire sécurisé par chiffrement adapté à la création d’un mot de passe aléatoire, utilisez une méthode telle que RNGCryptoServiceProvider.GetBytes.

Notes pour les héritiers

À compter de .NET Framework version 2.0, si vous dérivez une classe de Random et remplacez la méthode Sample(), la distribution fournie par l’implémentation de classe dérivée de la méthode Sample() n’est pas utilisée dans les appels à l’implémentation de classe de base de la méthode NextBytes(Byte[]). Au lieu de cela, la distribution uniforme retournée par la classe de base Random est utilisée. Ce comportement améliore les performances globales de la Random classe. Pour modifier ce comportement pour appeler la Sample() méthode dans la classe dérivée, vous devez également remplacer la NextBytes(Byte[]) méthode.

Voir aussi

• Byte

NextBytes(Span<Byte>)

Source:

Random.cs

Remplit les éléments d’une étendue d’octets spécifiée avec des nombres aléatoires.

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))

Paramètres

buffer

Span<Byte>

Tableau à remplir avec des nombres aléatoires.

Remarques

Chaque élément de l’étendue d’octets est défini sur un nombre aléatoire supérieur ou égal à 0 et inférieur ou égal à MaxValue.