Random Класс

Определение

Пространство имен:: System

Сборки:: mscorlib.dll, System.Runtime.Extensions.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.Extensions.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Исходный код:: Random.cs

Исходный код:: Random.cs

Исходный код:: Random.cs

Исходный код:: Random.cs

Исходный код:: Random.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет генератор псевдо-случайных чисел, который является алгоритмом, который создает последовательность чисел, которые соответствуют определенным статистическим требованиям для случайности.

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

Наследование: Object
Random

Атрибуты: SerializableAttribute ComVisibleAttribute

Примеры

В следующем примере создается один генератор случайных чисел и вызывается его NextBytes Next, а также NextDouble методы для создания последовательностей случайных чисел в разных диапазонах.

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

В следующем примере создается случайное целое число, которое используется в качестве индекса для получения строкового значения из массива.

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

Чтобы создать криптографически безопасное случайное число, например для создания случайного пароля, используйте один из статических методов в RandomNumberGenerator классе.

Дополнительные сведения об этом API см. в дополнительных примечаниях API для Случайного.

Примечания для тех, кто наследует этот метод

В .NET Framework 2.0 и NextBytes(Byte[]) более поздних версиях поведение Next()Next(Int32, Int32)методов изменилось таким образом, чтобы эти методы не обязательно вызывали реализацию производного Sample() класса метода. В результате классы, производные от Random этого целевого объекта .NET Framework 2.0 и более поздних версий, также должны переопределить эти три метода.

Примечания для тех, кто вызывает этот метод

Реализация генератора случайных чисел в Random классе не гарантируется, что она остается одинаковой в основных версиях .NET. В результате не следует предположить, что одно и то же начальное значение приведет к тому же псевдослучайной последовательности в разных версиях .NET.

Конструкторы

Имя	Описание
Random()	Инициализирует новый экземпляр Random класса с помощью начального значения по умолчанию.
Random(Int32)	Инициализирует новый экземпляр Random класса, используя указанное начальное значение.

Свойства

Имя	Описание
Shared	Предоставляет потокобезопасный Random экземпляр, который может использоваться одновременно из любого потока.

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetHexString(Int32, Boolean)	Создает строку, заполненную случайными шестнадцатеричными символами.
GetHexString(Span<Char>, Boolean)	Заполняет буфер случайными шестнадцатеричными символами.
GetItems<T>(ReadOnlySpan<T>, Int32)	Создает массив, заполненный элементами, выбранными случайным образом из предоставленного набора вариантов.
GetItems<T>(ReadOnlySpan<T>, Span<T>)	Заполняет элементы заданного диапазона элементами, выбранными случайным образом из предоставленного набора вариантов.
GetItems<T>(T[], Int32)	Создает массив, заполненный элементами, выбранными случайным образом из предоставленного набора вариантов.
GetString(ReadOnlySpan<Char>, Int32)	Создает строку, заполненную символами, выбранными случайным образом `choices`.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
Next()	Возвращает неотрицательное случайное целое число.
Next(Int32, Int32)	Возвращает случайное целое число, которое находится в заданном диапазоне.
Next(Int32)	Возвращает неотрицательное случайное целое число, которое меньше указанного максимума.
NextBytes(Byte[])	Заполняет элементы указанного массива байтов случайными числами.
NextBytes(Span<Byte>)	Заполняет элементы указанного диапазона байтов случайными числами.
NextDouble()	Возвращает случайное число с плавающей запятой, которое больше или равно 0,0 и меньше 1,0.
NextInt64()	Возвращает неотрицательное случайное целое число.
NextInt64(Int64, Int64)	Возвращает случайное целое число, которое находится в заданном диапазоне.
NextInt64(Int64)	Возвращает неотрицательное случайное целое число, которое меньше указанного максимума.
NextSingle()	Возвращает случайное число с плавающей запятой, которое больше или равно 0,0 и меньше 1,0.
Sample()	Возвращает случайное число с плавающей запятой от 0,0 до 1.0.
Shuffle<T>(Span<T>)	Выполняет перетасовку диапазона на месте.
Shuffle<T>(T[])	Выполняет перетасовку массива на месте.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Применяется к

Кері байланыс

Бет пайдалы болды ма?

Бөлісу құралы: