Random Classe

Definição

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.Extensions.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: Random.cs

Origem:: Random.cs

Origem:: Random.cs

Origem:: Random.cs

Origem:: Random.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um gerador de número pseudo-aleatório, que é um algoritmo que produz uma sequência de números que atendem a determinados requisitos estatísticos para aleatoriedade.

public ref class Random

public class Random

[System.Serializable]
public class Random

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Random

type Random = class

[<System.Serializable>]
type Random = class

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Random = class

Public Class Random

Herança: Object
Random

Atributos: SerializableAttribute ComVisibleAttribute

Exemplos

O exemplo a seguir cria um único gerador de número aleatório e chama seu NextBytes, Nexte NextDouble métodos para gerar sequências de números aleatórios dentro de intervalos diferentes.

// Instantiate random number generator using system-supplied value as seed.
var rand = new Random();

// Generate and display 5 random byte (integer) values.
byte[] bytes = new byte[5];
rand.NextBytes(bytes);
Console.WriteLine("Five random byte values:");
foreach (byte byteValue in bytes)
    Console.Write("{0, 5}", byteValue);
Console.WriteLine();

// Generate and display 5 random integers.
Console.WriteLine("Five random integer values:");
for (int ctr = 0; ctr <= 4; ctr++)
    Console.Write("{0,15:N0}", rand.Next());
Console.WriteLine();

// Generate and display 5 random integers between 0 and 100.
Console.WriteLine("Five random integers between 0 and 100:");
for (int ctr = 0; ctr <= 4; ctr++)
    Console.Write("{0,8:N0}", rand.Next(101));
Console.WriteLine();

// Generate and display 5 random integers from 50 to 100.
Console.WriteLine("Five random integers between 50 and 100:");
for (int ctr = 0; ctr <= 4; ctr++)
    Console.Write("{0,8:N0}", rand.Next(50, 101));
Console.WriteLine();

// Generate and display 5 random floating point values from 0 to 1.
Console.WriteLine("Five Doubles.");
for (int ctr = 0; ctr <= 4; ctr++)
    Console.Write("{0,8:N3}", rand.NextDouble());
Console.WriteLine();

// Generate and display 5 random floating point values from 0 to 5.
Console.WriteLine("Five Doubles between 0 and 5.");
for (int ctr = 0; ctr <= 4; ctr++)
    Console.Write("{0,8:N3}", rand.NextDouble() * 5);

// The example displays output like the following:
//    Five random byte values:
//      194  185  239   54  116
//    Five random integer values:
//        507,353,531  1,509,532,693  2,125,074,958  1,409,512,757    652,767,128
//    Five random integers between 0 and 100:
//          16      78      94      79      52
//    Five random integers between 50 and 100:
//          56      66      96      60      65
//    Five Doubles.
//       0.943   0.108   0.744   0.563   0.415
//    Five Doubles between 0 and 5.
//       2.934   3.130   0.292   1.432   4.369

// Instantiate random number generator using system-supplied value as seed.
let rand = Random()

// Generate and display 5 random byte (integer) values.
let bytes = Array.zeroCreate 5
rand.NextBytes bytes
printfn "Five random byte values:"
for byte in bytes do
    printf "%5i" byte
printfn ""

// Generate and display 5 random integers.
printfn "Five random integer values:"
for _ = 0 to 4 do
    printf $"{rand.Next(),15:N0}" 
printfn ""

// Generate and display 5 random integers between 0 and 100.
printfn "Five random integers between 0 and 100:"
for _ = 0 to 4 do
    printf $"{rand.Next 101,8:N0}"
printfn ""

// Generate and display 5 random integers from 50 to 100.
printfn "Five random integers between 50 and 100:"
for _ = 0 to 4 do
    printf $"{rand.Next(50, 101),8:N0}"
printfn ""

// Generate and display 5 random floating point values from 0 to 1.
printfn "Five Doubles."
for _ = 0 to 4 do
    printf $"{rand.NextDouble(),8:N3}"
printfn ""

// Generate and display 5 random floating point values from 0 to 5.
printfn "Five Doubles between 0 and 5."
for _ = 0 to 4 do
    printf $"{rand.NextDouble() * 5.0,8:N3}"

// The example displays output like the following:
//    Five random byte values:
//      194  185  239   54  116
//    Five random integer values:
//        507,353,531  1,509,532,693  2,125,074,958  1,409,512,757    652,767,128
//    Five random integers between 0 and 100:
//          16      78      94      79      52
//    Five random integers between 50 and 100:
//          56      66      96      60      65
//    Five Doubles.
//       0.943   0.108   0.744   0.563   0.415
//    Five Doubles between 0 and 5.
//       2.934   3.130   0.292   1.432   4.369

Module Example
   Public Sub Main()
      ' Instantiate random number generator using system-supplied value as seed.
      Dim rand As New Random()
      ' Generate and display 5 random byte (integer) values.
      Dim bytes(4) As Byte
      rand.NextBytes(bytes)
      Console.WriteLine("Five random byte values:")
      For Each byteValue As Byte In bytes
         Console.Write("{0, 5}", byteValue)
      Next
      Console.WriteLine()   
      ' Generate and display 5 random integers.
      Console.WriteLine("Five random integer values:")
      For ctr As Integer = 0 To 4
         Console.Write("{0,15:N0}", rand.Next)
      Next                     
      Console.WriteLine()
      ' Generate and display 5 random integers between 0 and 100.'
      Console.WriteLine("Five random integers between 0 and 100:")
      For ctr As Integer = 0 To 4
         Console.Write("{0,8:N0}", rand.Next(101))
      Next                     
      Console.WriteLine()
      ' Generate and display 5 random integers from 50 to 100.
      Console.WriteLine("Five random integers between 50 and 100:")
      For ctr As Integer = 0 To 4
         Console.Write("{0,8:N0}", rand.Next(50, 101))
      Next                     
      Console.WriteLine()
      ' Generate and display 5 random floating point values from 0 to 1.
      Console.WriteLine("Five Doubles.")
      For ctr As Integer = 0 To 4
         Console.Write("{0,8:N3}", rand.NextDouble())
      Next                     
      Console.WriteLine()
      ' Generate and display 5 random floating point values from 0 to 5.
      Console.WriteLine("Five Doubles between 0 and 5.")
      For ctr As Integer = 0 To 4
         Console.Write("{0,8:N3}", rand.NextDouble() * 5)
      Next                     
   End Sub
End Module
' The example displays output like the following:
'    Five random byte values:
'      194  185  239   54  116
'    Five random integer values:
'        507,353,531  1,509,532,693  2,125,074,958  1,409,512,757    652,767,128
'    Five random integers between 0 and 100:
'          16      78      94      79      52
'    Five random integers between 50 and 100:
'          56      66      96      60      65
'    Five Doubles.
'       0.943   0.108   0.744   0.563   0.415
'    Five Doubles between 0 and 5.
'       2.934   3.130   0.292   1.432   4.369

O exemplo a seguir gera um inteiro aleatório que ele usa como um índice para recuperar um valor de cadeia de caracteres de uma matriz.

Random rnd = new();
string[] malePetNames = [ "Rufus", "Bear", "Dakota", "Fido",
                        "Vanya", "Samuel", "Koani", "Volodya",
                        "Prince", "Yiska" ];
string[] femalePetNames = [ "Maggie", "Penny", "Saya", "Princess",
                          "Abby", "Laila", "Sadie", "Olivia",
                          "Starlight", "Talla" ];

// Generate random indexes for pet names.
int mIndex = rnd.Next(malePetNames.Length);
int fIndex = rnd.Next(femalePetNames.Length);

// Display the result.
Console.WriteLine("Suggested pet name of the day: ");
Console.WriteLine($"   For a male:     {malePetNames[mIndex]}");
Console.WriteLine($"   For a female:   {femalePetNames[fIndex]}");

// The example displays output similar to the following:
//       Suggested pet name of the day:
//          For a male:     Koani
//          For a female:   Maggie

let rnd = Random()

let malePetNames =
    [| "Rufus"; "Bear"; "Dakota"; "Fido";
        "Vanya"; "Samuel"; "Koani"; "Volodya";
        "Prince"; "Yiska" |]
let femalePetNames = 
    [| "Maggie"; "Penny"; "Saya"; "Princess";
        "Abby"; "Laila"; "Sadie"; "Olivia";
        "Starlight"; "Talla" |]

// Generate random indexes for pet names.
let mIndex = rnd.Next malePetNames.Length
let fIndex = rnd.Next femalePetNames.Length

// Display the result.
printfn "Suggested pet name of the day: "
printfn "   For a male:     %s" malePetNames.[mIndex]
printfn "   For a female:   %s" femalePetNames.[fIndex]

// The example displays output similar to the following:
//       Suggested pet name of the day:
//          For a male:     Koani
//          For a female:   Maggie

Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim malePetNames() As String = { "Rufus", "Bear", "Dakota", "Fido", 
                                    "Vanya", "Samuel", "Koani", "Volodya", 
                                    "Prince", "Yiska" }
      Dim femalePetNames() As String = { "Maggie", "Penny", "Saya", "Princess", 
                                         "Abby", "Laila", "Sadie", "Olivia", 
                                         "Starlight", "Talla" }                                      
      
      ' Generate random indexes for pet names.
      Dim mIndex As Integer = rnd.Next(malePetNames.Length)
      Dim fIndex As Integer = rnd.Next(femalePetNames.Length)
      
      ' Display the result.
      Console.WriteLine("Suggested pet name of the day: ")
      Console.WriteLine("   For a male:     {0}", malePetNames(mIndex))
      Console.WriteLine("   For a female:   {0}", femalePetNames(fIndex))
   End Sub
End Module
' The example displays output similar to the following:
'       Suggested pet name of the day:
'          For a male:     Koani
'          For a female:   Maggie

Comentários

Observação

Para gerar um número aleatório criptograficamente seguro, como um que seja adequado para criar uma senha aleatória, use um dos métodos estáticos da RandomNumberGenerator classe.

Para obter mais informações sobre essa API, consulte comentários de API Suplementar para Random.

Notas aos Herdeiros

No .NET Framework 2.0 e posterior, o comportamento do método e NextBytes(Byte[]) do Next()método Next(Int32, Int32)foram alterados para que esses métodos não necessariamente chamem a implementação de classe derivada do Sample() método. Como resultado, as classes derivadas desse Random .NET Framework 2.0 de destino e posteriores também devem substituir esses três métodos.

Notas aos Chamadores

A implementação do gerador de número aleatório na Random classe não tem a garantia de permanecer a mesma em versões principais do .NET. Como resultado, você não deve assumir que a mesma semente resultará na mesma sequência pseudo-aleatória em diferentes versões do .NET.

Construtores

Nome	Description
Random()	Inicializa uma nova instância da Random classe usando um valor de semente padrão.
Random(Int32)	Inicializa uma nova instância da Random classe usando o valor de semente especificado.

Propriedades

Nome	Description
Shared	Fornece uma instância thread-safe Random que pode ser usada simultaneamente de qualquer thread.

Métodos

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetHexString(Int32, Boolean)	Cria uma cadeia de caracteres preenchida com caracteres hexadecimal aleatórios.
GetHexString(Span<Char>, Boolean)	Preenche um buffer com caracteres hexadecimal aleatórios.
GetItems<T>(ReadOnlySpan<T>, Int32)	Cria uma matriz preenchida com itens escolhidos aleatoriamente do conjunto de opções fornecido.
GetItems<T>(ReadOnlySpan<T>, Span<T>)	Preenche os elementos de um intervalo especificado com itens escolhidos aleatoriamente do conjunto de opções fornecido.
GetItems<T>(T[], Int32)	Cria uma matriz preenchida com itens escolhidos aleatoriamente do conjunto de opções fornecido.
GetString(ReadOnlySpan<Char>, Int32)	Cria uma cadeia de caracteres preenchida com caracteres escolhidos aleatoriamente de `choices`.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
Next()	Retorna um inteiro aleatório não negativo.
Next(Int32, Int32)	Retorna um inteiro aleatório que está dentro de um intervalo especificado.
Next(Int32)	Retorna um inteiro aleatório não negativo menor que o máximo especificado.
NextBytes(Byte[])	Preenche os elementos de uma matriz de bytes especificada com números aleatórios.
NextBytes(Span<Byte>)	Preenche os elementos de um intervalo especificado de bytes com números aleatórios.
NextDouble()	Retorna um número de ponto flutuante aleatório maior ou igual a 0,0 e menor que 1,0.
NextInt64()	Retorna um inteiro aleatório não negativo.
NextInt64(Int64, Int64)	Retorna um inteiro aleatório que está dentro de um intervalo especificado.
NextInt64(Int64)	Retorna um inteiro aleatório não negativo menor que o máximo especificado.
NextSingle()	Retorna um número de ponto flutuante aleatório maior ou igual a 0,0 e menor que 1,0.
Sample()	Retorna um número de ponto flutuante aleatório entre 0,0 e 1,0.
Shuffle<T>(Span<T>)	Executa um embaralhamento in-loco de um intervalo.
Shuffle<T>(T[])	Executa um embaralhamento in-loco de uma matriz.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Comentários

Esta página foi útil?

Compartilhar via

Random Classe

Definição

Exemplos

Comentários

Notas aos Herdeiros

Notas aos Chamadores

Construtores

Propriedades

Métodos

Aplica-se a

Comentários