Random 클래스

정의

네임스페이스:: System

어셈블리:: mscorlib.dll, System.Runtime.Extensions.dll

어셈블리:: netstandard.dll, System.Runtime.dll

어셈블리:: System.Runtime.Extensions.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

Source:: Random.cs

Source:: Random.cs

Source:: Random.cs

Source:: Random.cs

Source:: Random.cs

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

난수에 대한 특정 통계 요구 사항을 충족하는 숫자 시퀀스를 생성하는 알고리즘인 의사 난수 생성기를 나타냅니다.

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 이상에서는 이러한 메서드가 메서드의 Next()파생 클래스 구현을 반드시 호출하지 않도록 , Next(Int32, Int32)및 NextBytes(Byte[]) 메서드의 동작이 Sample() 변경되었습니다. 따라서 해당 대상 .NET Framework 2.0 이상에서 Random 파생된 클래스도 이러한 세 가지 메서드를 재정의해야 합니다.

호출자 참고

클래스에서 난수 생성기의 Random 구현은 .NET의 주 버전에서 동일하게 유지되지 않습니다. 따라서 동일한 시드가 다른 버전의 .NET에서 동일한 의사 임의 시퀀스를 생성한다고 가정해서는 안 됩니다.

생성자

Name	Description
Random()	기본 시드 값을 사용하여 클래스의 Random 새 인스턴스를 초기화합니다.
Random(Int32)	지정된 시드 값을 사용하여 클래스의 Random 새 인스턴스를 초기화합니다.

속성

Name	Description
Shared	스레드에서 동시에 사용할 수 있는 스레드로부터 안전한 Random 인스턴스를 제공합니다.

메서드

Name	Description
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetHexString(Int32, Boolean)	임의의 16진수 문자로 채워진 문자열을 만듭니다.
GetHexString(Span<Char>, Boolean)	임의의 16진수 문자로 버퍼를 채웁니다.
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)

적용 대상

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

Random 클래스

정의

예제

설명

상속자 참고

호출자 참고

생성자

속성

메서드

적용 대상

피드백