# Random Klasse

## Definition

Stellt einen Generator für Pseudozufallszahlen dar, d. h. ein Algorithmus, der eine Zahlenfolge erzeugt, die bestimmte statistische Anforderungen hinsichtlich ihrer Zufälligkeit erfüllt.Represents a pseudo-random number generator, which is an algorithm that produces a sequence of numbers that meet certain statistical requirements for randomness.

``public ref class Random``
``public class Random``
``````[System.Serializable]
public class Random``````
``````[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class Random``````
``type Random = class``
``Public Class Random``
Vererbung
Random
Attribute

## Beispiele

Im folgenden Beispiel wird ein einzelner Zufallszahlengenerator erstellt und seine Methoden NextBytes, Nextund NextDouble aufgerufen, um Sequenzen von Zufallszahlen in verschiedenen Bereichen zu generieren.The following example creates a single random number generator and calls its NextBytes, Next, and NextDouble methods to generate sequences of random numbers within different ranges.

``````using namespace System;

void main()
{
// Instantiate random number generator using system-supplied value as seed.
Random^ rand = gcnew Random();
// Generate and display 5 random byte (integer) values.
array<Byte>^ bytes = gcnew array<Byte>(4);
rand->NextBytes(bytes);
Console::WriteLine("Five random byte values:");
for each (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.
var rand = new Random();

// Generate and display 5 random byte (integer) values.
var 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
``````
``````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
``````

Im folgenden Beispiel wird eine zufällige ganze Zahl generiert, die als Index zum Abrufen eines Zeichen folgen Werts aus einem Array verwendet wird.The following example generates a random integer that it uses as an index to retrieve a string value from an array.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
array<String^>^ malePetNames = { "Rufus", "Bear", "Dakota", "Fido",
"Vanya", "Samuel", "Koani", "Volodya",
"Prince", "Yiska" };
array<String^>^ femalePetNames = { "Maggie", "Penny", "Saya", "Princess",
"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:     {0}", malePetNames[mIndex]);
Console::WriteLine("   For a female:   {0}", femalePetNames[fIndex]);
}
// The example displays the following output:
//       Suggested pet name of the day:
//          For a male:     Koani
//          For a female:   Maggie
``````
``````Random rnd = new Random();
string[] malePetNames = { "Rufus", "Bear", "Dakota", "Fido",
"Vanya", "Samuel", "Koani", "Volodya",
"Prince", "Yiska" };
string[] femalePetNames = { "Maggie", "Penny", "Saya", "Princess",
"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:     {0}", malePetNames[mIndex]);
Console.WriteLine("   For a female:   {0}", femalePetNames[fIndex]);

// The example displays the following output:
//       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",
"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 like the following:
'       Suggested pet name of the day:
'          For a male:     Koani
'          For a female:   Maggie
``````

## Hinweise

Pseudo Zufallszahlen werden mit gleicher Wahrscheinlichkeit aus einem begrenzten Satz von Zahlen ausgewählt.Pseudo-random numbers are chosen with equal probability from a finite set of numbers. Die ausgewählten Zahlen sind nicht vollständig zufällig, da Sie mit einem mathematischen Algorithmus ausgewählt werden, Sie sind jedoch für praktische Zwecke ausreichend.The chosen numbers are not completely random because a mathematical algorithm is used to select them, but they are sufficiently random for practical purposes. Die aktuelle Implementierung der Random-Klasse basiert auf einer geänderten Version des subtraktiven Zufallszahlen-Generator Algorithmus von Donald E. Knuth.The current implementation of the Random class is based on a modified version of Donald E. Knuth's subtractive random number generator algorithm. Weitere Informationen finden Sie unter D. E.For more information, see D. E. Knuth.Knuth. Die Art der Computer Programmierung, Volume 2: seminumerische Algorithmen.The Art of Computer Programming, Volume 2: Seminumerical Algorithms. Addison-Wesley, Reading, MA, dritte Edition, 1997.Addison-Wesley, Reading, MA, third edition, 1997.

Um eine kryptografisch sichere Zufallszahl zu generieren, z. b. eine, die zum Erstellen eines zufälligen Kennworts geeignet ist, verwenden Sie die RNGCryptoServiceProvider-Klasse, oder leiten Sie eine Klasse von System.Security.Cryptography.RandomNumberGeneratorab.To generate a cryptographically secure random number, such as one that's suitable for creating a random password, use the RNGCryptoServiceProvider class or derive a class from System.Security.Cryptography.RandomNumberGenerator.

Inhalte dieses Themas:In this topic:

### Instanziieren des Zufallszahlen-GeneratorsInstantiating the random number generator

Sie instanziieren den Zufallszahlengenerator, indem Sie einen Ausgangswert (einen Startwert für den Algorithmus für die Pseudozufallszahlen Generierung) einem Random-Klassenkonstruktor bereitstellen.You instantiate the random number generator by providing a seed value (a starting value for the pseudo-random number generation algorithm) to a Random class constructor. Sie können den Seed-Wert entweder explizit oder implizit angeben:You can supply the seed value either explicitly or implicitly:

• Der Random(Int32)-Konstruktor verwendet einen expliziten Ausgangswert, den Sie angeben.The Random(Int32) constructor uses an explicit seed value that you supply.

• Der Random()-Konstruktor verwendet die Systemuhr, um einen Ausgangswert bereitzustellen.The Random() constructor uses the system clock to provide a seed value. Dies ist die gängigste Methode zum Instanziieren des Zufallszahlen-Generators.This is the most common way of instantiating the random number generator.

Wenn derselbe Ausgangswert für separate Random Objekte verwendet wird, generieren Sie dieselbe Reihe von Zufallszahlen.If the same seed is used for separate Random objects, they will generate the same series of random numbers. Dies kann nützlich sein, um eine Test Sammlung zu erstellen, die zufällige Werte verarbeitet, oder um Spiele wiedergeben, die Ihre Daten von Zufallszahlen ableiten.This can be useful for creating a test suite that processes random values, or for replaying games that derive their data from random numbers. Beachten Sie jedoch, dass Random Objekte in Prozessen, die unter verschiedenen Versionen der .NET Framework ausgeführt werden, möglicherweise andere Serien von Zufallszahlen zurückgeben, selbst wenn Sie mit identischen Ausgangswerten instanziiert werden.However, note that Random objects in processes running under different versions of the .NET Framework may return different series of random numbers even if they're instantiated with identical seed values.

Um verschiedene Sequenzen von Zufallszahlen zu erzeugen, können Sie den Seed-Wert Zeit abhängig machen und so eine andere Reihe mit jeder neuen Instanz von Randomerzeugen.To produce different sequences of random numbers, you can make the seed value time-dependent, thereby producing a different series with each new instance of Random. Der parametrisierte Random(Int32) Konstruktor kann basierend auf der Anzahl der Ticks in der aktuellen Zeit einen Int32 Wert annehmen, während der Parameter lose Random() Konstruktor die Systemuhr verwendet, um den Ausgangswert zu generieren.The parameterized Random(Int32) constructor can take an Int32 value based on the number of ticks in the current time, whereas the parameterless Random() constructor uses the system clock to generate its seed value. Allerdings werden nur im .NET Framework, da die Uhr eine begrenzte Auflösung aufweist und der Parameter lose Konstruktor verwendet wird, um unterschiedliche Random Objekte in der Schluss Folge zu erstellen, Zufallszahlengeneratoren erstellt, die identische Sequenzen von Zufallszahlen erzeugen.However, on the .NET Framework only, because the clock has finite resolution, using the parameterless constructor to create different Random objects in close succession creates random number generators that produce identical sequences of random numbers. Im folgenden Beispiel wird veranschaulicht, wie zwei Random-Objekte, die in einer .NET Framework-Anwendung in unmittelbarer Folge instanziiert werden, eine identische Reihe von Zufallszahlen generieren.The following example illustrates how two Random objects that are instantiated in close succession in a .NET Framework application generate an identical series of random numbers. Bei den meisten Windows-Systemen haben Random Objekte, die innerhalb von 15 Millisekunden von einem anderen erstellt werden, wahrscheinlich identische Seed-Werte.On most Windows systems, Random objects created within 15 milliseconds of one another are likely to have identical seed values.

``````using namespace System;

void main()
{
array<Byte>^ bytes1 = gcnew array<Byte>(100);
array<Byte>^ bytes2 = gcnew array<Byte>(100);
Random^ rnd1 = gcnew Random();
Random^ rnd2 = gcnew Random();

rnd1->NextBytes(bytes1);
rnd2->NextBytes(bytes2);

Console::WriteLine("First Series:");
for (int ctr = bytes1->GetLowerBound(0);
ctr <= bytes1->GetUpperBound(0);
ctr++) {
Console::Write("{0, 5}", bytes1[ctr]);
if ((ctr + 1) % 10 == 0) Console::WriteLine();
}
Console::WriteLine();
Console::WriteLine("Second Series:");
for (int ctr = bytes2->GetLowerBound(0);
ctr <= bytes2->GetUpperBound(0);
ctr++) {
Console::Write("{0, 5}", bytes2[ctr]);
if ((ctr + 1) % 10 == 0) Console::WriteLine();
}
}
// The example displays output like the following:
//       First Series:
//          97  129  149   54   22  208  120  105   68  177
//         113  214   30  172   74  218  116  230   89   18
//          12  112  130  105  116  180  190  200  187  120
//           7  198  233  158   58   51   50  170   98   23
//          21    1  113   74  146  245   34  255   96   24
//         232  255   23    9  167  240  255   44  194   98
//          18  175  173  204  169  171  236  127  114   23
//         167  202  132   65  253   11  254   56  214  127
//         145  191  104  163  143    7  174  224  247   73
//          52    6  231  255    5  101   83  165  160  231
//
//       Second Series:
//          97  129  149   54   22  208  120  105   68  177
//         113  214   30  172   74  218  116  230   89   18
//          12  112  130  105  116  180  190  200  187  120
//           7  198  233  158   58   51   50  170   98   23
//          21    1  113   74  146  245   34  255   96   24
//         232  255   23    9  167  240  255   44  194   98
//          18  175  173  204  169  171  236  127  114   23
//         167  202  132   65  253   11  254   56  214  127
//         145  191  104  163  143    7  174  224  247   73
//          52    6  231  255    5  101   83  165  160  231
``````
``````byte[] bytes1 = new byte[100];
byte[] bytes2 = new byte[100];
Random rnd1 = new Random();
Random rnd2 = new Random();

rnd1.NextBytes(bytes1);
rnd2.NextBytes(bytes2);

Console.WriteLine("First Series:");
for (int ctr = bytes1.GetLowerBound(0);
ctr <= bytes1.GetUpperBound(0);
ctr++) {
Console.Write("{0, 5}", bytes1[ctr]);
if ((ctr + 1) % 10 == 0) Console.WriteLine();
}

Console.WriteLine();

Console.WriteLine("Second Series:");
for (int ctr = bytes2.GetLowerBound(0);
ctr <= bytes2.GetUpperBound(0);
ctr++) {
Console.Write("{0, 5}", bytes2[ctr]);
if ((ctr + 1) % 10 == 0) Console.WriteLine();
}

// The example displays output like the following:
//       First Series:
//          97  129  149   54   22  208  120  105   68  177
//         113  214   30  172   74  218  116  230   89   18
//          12  112  130  105  116  180  190  200  187  120
//           7  198  233  158   58   51   50  170   98   23
//          21    1  113   74  146  245   34  255   96   24
//         232  255   23    9  167  240  255   44  194   98
//          18  175  173  204  169  171  236  127  114   23
//         167  202  132   65  253   11  254   56  214  127
//         145  191  104  163  143    7  174  224  247   73
//          52    6  231  255    5  101   83  165  160  231
//
//       Second Series:
//          97  129  149   54   22  208  120  105   68  177
//         113  214   30  172   74  218  116  230   89   18
//          12  112  130  105  116  180  190  200  187  120
//           7  198  233  158   58   51   50  170   98   23
//          21    1  113   74  146  245   34  255   96   24
//         232  255   23    9  167  240  255   44  194   98
//          18  175  173  204  169  171  236  127  114   23
//         167  202  132   65  253   11  254   56  214  127
//         145  191  104  163  143    7  174  224  247   73
//          52    6  231  255    5  101   83  165  160  231
``````
``````Module modMain

Public Sub Main()
Dim bytes1(99), bytes2(99) As Byte
Dim rnd1 As New Random()
Dim rnd2 As New Random()

rnd1.NextBytes(bytes1)
rnd2.NextBytes(bytes2)

Console.WriteLine("First Series:")
For ctr As Integer = bytes1.GetLowerBound(0) to bytes1.GetUpperBound(0)
Console.Write("{0, 5}", bytes1(ctr))
If (ctr + 1) Mod 10 = 0 Then Console.WriteLine()
Next
Console.WriteLine()
Console.WriteLine("Second Series:")
For ctr As Integer = bytes2.GetLowerBound(0) to bytes2.GetUpperBound(0)
Console.Write("{0, 5}", bytes2(ctr))
If (ctr + 1) Mod 10 = 0 Then Console.WriteLine()
Next
End Sub
End Module
' The example displays output like the following:
'       First Series:
'          97  129  149   54   22  208  120  105   68  177
'         113  214   30  172   74  218  116  230   89   18
'          12  112  130  105  116  180  190  200  187  120
'           7  198  233  158   58   51   50  170   98   23
'          21    1  113   74  146  245   34  255   96   24
'         232  255   23    9  167  240  255   44  194   98
'          18  175  173  204  169  171  236  127  114   23
'         167  202  132   65  253   11  254   56  214  127
'         145  191  104  163  143    7  174  224  247   73
'          52    6  231  255    5  101   83  165  160  231
'
'       Second Series:
'          97  129  149   54   22  208  120  105   68  177
'         113  214   30  172   74  218  116  230   89   18
'          12  112  130  105  116  180  190  200  187  120
'           7  198  233  158   58   51   50  170   98   23
'          21    1  113   74  146  245   34  255   96   24
'         232  255   23    9  167  240  255   44  194   98
'          18  175  173  204  169  171  236  127  114   23
'         167  202  132   65  253   11  254   56  214  127
'         145  191  104  163  143    7  174  224  247   73
'          52    6  231  255    5  101   83  165  160  231
``````

Um dieses Problem zu vermeiden, erstellen Sie ein einzelnes Random Objekt anstelle mehrerer Objekte.To avoid this problem, create a single Random object instead of multiple objects. Beachten Sie, dass die `Random`-Klasse in .net Core diese Einschränkung nicht besitzt.Note that the `Random` class in .NET Core does not have this limitation.

### Vermeiden mehrerer InstanziierungenAvoiding multiple instantiations

In der .NET Framework werden durch die Initialisierung von zwei Zufallszahlengeneratoren in einer engen Schleife oder in schneller Folge zwei Zufallszahlengeneratoren erstellt, die identische Sequenzen von Zufallszahlen erzeugen können.On the .NET Framework, initializing two random number generators in a tight loop or in rapid succession creates two random number generators that can produce identical sequences of random numbers. In den meisten Fällen ist dies nicht die Absicht des Entwicklers und kann zu Leistungsproblemen führen, da die Instanziierung und Initialisierung eines Zufallszahlengenerators ein relativ kostspieliger Prozess ist.In most cases, this is not the developer's intent and can lead to performance issues, because instantiating and initializing a random number generator is a relatively expensive process.

Um die Leistung zu verbessern und nicht versehentlich separate Zufallszahlengeneratoren zu erstellen, die identische numerische Sequenzen generieren, empfiehlt es sich, ein Random Objekt zu erstellen, das viele Zufallszahlen generiert, anstatt neue Random Objekte zu erstellen, um eine Zufallszahl zu generieren.Both to improve performance and to avoid inadvertently creating separate random number generators that generate identical numeric sequences, we recommend that you create one Random object to generate many random numbers over time, instead of creating new Random objects to generate one random number.

Die Random-Klasse ist jedoch nicht Thread sicher.However, the Random class isn't thread safe. Wenn Sie Random Methoden aus mehreren Threads abrufen, befolgen Sie die im nächsten Abschnitt beschriebenen Richtlinien.If you call Random methods from multiple threads, follow the guidelines discussed in the next section.

### Die System. Random-Klasse und die Thread SicherheitThe System.Random class and thread safety

Im folgenden Beispiel wird die C# lock-Anweisung und die Visual Basic SyncLock-Anweisung verwendet, um sicherzustellen, dass der Zugriff auf einen einzelnen Zufallszahlengenerator von 11 Threads Thread sicher erfolgt.The following example uses the C# lock Statement and the Visual Basic SyncLock statement to ensure that a single random number generator is accessed by 11 threads in a thread-safe manner. Jeder Thread generiert 2 Millionen Zufallszahlen, zählt die Anzahl der generierten Zufallszahlen und berechnet seine Summe und aktualisiert dann die Summen für alle Threads, wenn die Ausführung abgeschlossen ist.Each thread generates 2 million random numbers, counts the number of random numbers generated and calculates their sum, and then updates the totals for all threads when it finishes executing.

``````using namespace System;

ref class Example
{
private:
[ThreadStatic] static double previous = 0.0;
static CancellationTokenSource^ source;
static CountdownEvent^ countdown;
static Object^ randLock;
static Object^ numericLock;
static Random^ rand;
double totalValue = 0.0;
int totalCount = 0;

public:
Example()
{
rand = gcnew Random();
randLock = gcnew Object();
numericLock = gcnew Object();
countdown = gcnew CountdownEvent(1);
source = gcnew CancellationTokenSource();
}

void Execute()
{
CancellationToken^ token = source->Token;

{
}
this->GetRandomNumbers(token);

countdown->Signal();
// Make sure all threads have finished.
countdown->Wait();

Console::WriteLine("\nTotal random numbers generated: {0:N0}", totalCount);
Console::WriteLine("Total sum of all random numbers: {0:N2}", totalValue);
Console::WriteLine("Random number mean: {0:N4}", totalValue/totalCount);
}

private:
void GetRandomNumbers(Object^ o)
{
CancellationToken^ token = (CancellationToken) o;
double result = 0.0;

try {
for (int ctr = 0; ctr < 2000000; ctr++)
{
// Make sure there's no corruption of Random.
token->ThrowIfCancellationRequested();

Monitor::Enter(randLock);
result = rand->NextDouble();
Monitor::Exit(randLock);
// Check for corruption of Random instance.
if ((result == previous) && result == 0) {
source->Cancel();
}
else {
previous = result;
}
}

Console::WriteLine("Sum of random numbers: {0:N2}", perThreadTotal);

// Update overall totals.
Monitor::Enter(numericLock);
Monitor::Exit(numericLock);
}
catch (OperationCanceledException^ e) {
}
finally {
countdown->Signal();
}
}
};

void main()
{
Example^ ex = gcnew Example();
ex->Execute();
}
// The example displays output like the following:
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,491.05
//       Random number mean: 0.5002
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,329.64
//       Random number mean: 0.4997
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,166.89
//       Random number mean: 0.5001
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,628.37
//       Random number mean: 0.4998
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,920.89
//       Random number mean: 0.5000
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,370.45
//       Random number mean: 0.4997
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,330.92
//       Random number mean: 0.4997
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,172.79
//       Random number mean: 0.5001
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,079.43
//       Random number mean: 0.5000
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,817.91
//       Random number mean: 0.4999
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,930.63
//       Random number mean: 0.5000
//
//
//       Total random numbers generated: 22,000,000
//       Total sum of all random numbers: 10,998,238.98
//       Random number mean: 0.4999
``````
``````using System;

public class Example
{
[ThreadStatic] static double previous = 0.0;
static CancellationTokenSource source;
static CountdownEvent countdown;
static Object randLock, numericLock;
static Random rand;
double totalValue = 0.0;
int totalCount = 0;

public Example()
{
rand = new Random();
randLock = new Object();
numericLock = new Object();
countdown = new CountdownEvent(1);
source = new CancellationTokenSource();
}

public static void Main()
{
Example ex = new Example();
ex.Execute();
}

private void Execute()
{
CancellationToken token = source.Token;

{
}
this.GetRandomNumbers(token);

countdown.Signal();
// Make sure all threads have finished.
countdown.Wait();
source.Dispose();

Console.WriteLine("\nTotal random numbers generated: {0:N0}", totalCount);
Console.WriteLine("Total sum of all random numbers: {0:N2}", totalValue);
Console.WriteLine("Random number mean: {0:N4}", totalValue/totalCount);
}

private void GetRandomNumbers(Object o)
{
CancellationToken token = (CancellationToken) o;
double result = 0.0;

try {
for (int ctr = 0; ctr < 2000000; ctr++)
{
// Make sure there's no corruption of Random.
token.ThrowIfCancellationRequested();

lock (randLock) {
result = rand.NextDouble();
}
// Check for corruption of Random instance.
if ((result == previous) && result == 0) {
source.Cancel();
}
else {
previous = result;
}
}

Console.WriteLine("Sum of random numbers: {0:N2}", perThreadTotal);

// Update overall totals.
lock (numericLock) {
}
}
catch (OperationCanceledException e) {
}
finally {
countdown.Signal();
}
}
}
// The example displays output like the following:
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,491.05
//       Random number mean: 0.5002
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,329.64
//       Random number mean: 0.4997
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,166.89
//       Random number mean: 0.5001
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,628.37
//       Random number mean: 0.4998
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,920.89
//       Random number mean: 0.5000
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,370.45
//       Random number mean: 0.4997
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,330.92
//       Random number mean: 0.4997
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,172.79
//       Random number mean: 0.5001
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,079.43
//       Random number mean: 0.5000
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,817.91
//       Random number mean: 0.4999
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,930.63
//       Random number mean: 0.5000
//
//
//       Total random numbers generated: 22,000,000
//       Total sum of all random numbers: 10,998,238.98
//       Random number mean: 0.4999
``````
``````Imports System.Threading

Module Example
<ThreadStatic> Dim previous As Double = 0.0
Dim source As New CancellationTokenSource()
Dim countdown As New CountdownEvent(1)
Dim randLock As New Object()
Dim numericLock As New Object()
Dim rand As New Random()
Dim totalValue As Double = 0.0
Dim totalCount As Integer = 0

Public Sub Main()

Dim token As CancellationToken = source.Token
For threads As Integer = 1 To 10
Next
GetRandomNumbers(token)

countdown.Signal()
' Make sure all threads have finished.
countdown.Wait()

Console.WriteLine()
Console.WriteLine("Total random numbers generated: {0:N0}", totalCount)
Console.WriteLine("Total sum of all random numbers: {0:N2}", totalValue)
Console.WriteLine("Random number mean: {0:N4}", totalValue/totalCount)
End Sub

Private Sub GetRandomNumbers(o As Object)
Dim token As CancellationToken = CType(o, CancellationToken)
Dim result As Double = 0.0

Try
For ctr As Integer = 1 To 2000000
' Make sure there's no corruption of Random.
token.ThrowIfCancellationRequested()

SyncLock randLock
result = rand.NextDouble()
End SyncLock
' Check for corruption of Random instance.
If result = previous AndAlso result = 0 Then
source.Cancel()
Else
previous = result
End If
Next

Console.WriteLine("Sum of random numbers: {0:N2}", perThreadTotal)
Console.WriteLine()

' Update overall totals.
SyncLock numericLock
End SyncLock
Catch e As OperationCanceledException
Finally
countdown.Signal()
source.Dispose()
End Try
End Sub
End Module
' The example displays output like the following:
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,491.05
'       Random number mean: 0.5002
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,329.64
'       Random number mean: 0.4997
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,166.89
'       Random number mean: 0.5001
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,628.37
'       Random number mean: 0.4998
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,920.89
'       Random number mean: 0.5000
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,370.45
'       Random number mean: 0.4997
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,330.92
'       Random number mean: 0.4997
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,172.79
'       Random number mean: 0.5001
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,079.43
'       Random number mean: 0.5000
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,817.91
'       Random number mean: 0.4999
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,930.63
'       Random number mean: 0.5000
'
'
'       Total random numbers generated: 22,000,000
'       Total sum of all random numbers: 10,998,238.98
'       Random number mean: 0.4999
``````

Im Beispiel wird die Thread Sicherheit auf folgende Weise sichergestellt:The example ensures thread-safety in the following ways:

• Das ThreadStaticAttribute-Attribut wird verwendet, um Thread lokale Variablen zu definieren, mit denen die Gesamtzahl der generierten Zufallszahlen und deren Summe für jeden Thread nachverfolgt wird.The ThreadStaticAttribute attribute is used to define thread-local variables that track the total number of random numbers generated and their sum for each thread.

• Eine Sperre (die `lock`-Anweisung C# in und die `SyncLock`-Anweisung in Visual Basic) schützt den Zugriff auf die Variablen für die Gesamtanzahl und Summe aller Zufallszahlen, die für alle Threads generiert werden.A lock (the `lock` statement in C# and the `SyncLock` statement in Visual Basic) protects access to the variables for the total count and sum of all random numbers generated on all threads.

• Ein Semaphor (das CountdownEvent Objekt) wird verwendet, um sicherzustellen, dass der Haupt Thread blockiert wird, bis alle anderen Threads die Ausführung vollständig erfüllen.A semaphore (the CountdownEvent object) is used to ensure that the main thread blocks until all other threads complete execution.

• Im Beispiel wird überprüft, ob der Zufallszahlen-Generator beschädigt wurde, indem ermittelt wird, ob zwei aufeinander folgende Aufrufe der Zufallszahlen Generierungs Methode 0 zurückgeben.The example checks whether the random number generator has become corrupted by determining whether two consecutive calls to random number generation methods return 0. Wenn eine Beschädigung erkannt wird, wird im Beispiel das CancellationTokenSource-Objekt verwendet, um zu signalisieren, dass alle Threads abgebrochen werden sollen.If corruption is detected, the example uses the CancellationTokenSource object to signal that all threads should be canceled.

• Vor dem Erstellen der Zufallszahl überprüft jeder Thread den Status des CancellationToken Objekts.Before generating each random number, each thread checks the state of the CancellationToken object. Wenn der Abbruch angefordert wird, ruft das Beispiel die CancellationToken.ThrowIfCancellationRequested-Methode auf, um den Thread abzubrechen.If cancellation is requested, the example calls the CancellationToken.ThrowIfCancellationRequested method to cancel the thread.

Das folgende Beispiel ist mit dem ersten identisch, mit der Ausnahme, dass es ein Task Objekt und einen Lambda-Ausdruck anstelle von Thread-Objekten verwendet.The following example is identical to the first, except that it uses a Task object and a lambda expression instead of Thread objects.

``````using System;
using System.Collections.Generic;

public class Example
{
static Object randLock, numericLock;
static Random rand;
static CancellationTokenSource source;
double totalValue = 0.0;
int totalCount = 0;

public Example()
{
rand = new Random();
randLock = new Object();
numericLock = new Object();
source = new CancellationTokenSource();
}

{
Example ex = new Example();
await ex.Execute();
}

{

for (int ctr = 0; ctr <= 10; ctr++)
{
CancellationToken token = source.Token;
{
double previous = 0.0;
double result = 0.0;

for (int n = 0; n < 2000000; n++)
{
// Make sure there's no corruption of Random.
token.ThrowIfCancellationRequested();

lock (randLock) {
result = rand.NextDouble();
}
// Check for corruption of Random instance.
if ((result == previous) && result == 0) {
source.Cancel();
}
else {
previous = result;
}
}

// Show result.
Console.WriteLine("Sum of random numbers: {0:N2}", taskTotal);

// Update overall totals.
lock (numericLock) {
}
},
token));
}
try {
Console.WriteLine("\nTotal random numbers generated: {0:N0}", totalCount);
Console.WriteLine("Total sum of all random numbers: {0:N2}", totalValue);
Console.WriteLine("Random number mean: {0:N4}", totalValue/totalCount);
}
catch (AggregateException e) {
foreach (Exception inner in e.InnerExceptions) {
if (canc != null)
else
Console.WriteLine("Exception: {0}", inner.GetType().Name);
}
}
finally {
source.Dispose();
}
}
}
// The example displays output like the following:
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,502.47
//       Random number mean: 0.5003
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,445.63
//       Random number mean: 0.5002
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,556.04
//       Random number mean: 0.5003
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,178.87
//       Random number mean: 0.5001
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,819.17
//       Random number mean: 0.4999
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,190.58
//       Random number mean: 0.5001
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,720.21
//       Random number mean: 0.4999
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,000.96
//       Random number mean: 0.4995
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,499.33
//       Random number mean: 0.4997
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 1,000,193.25
//       Random number mean: 0.5001
//
//       Random numbers generated: 2,000,000
//       Sum of random numbers: 999,960.82
//       Random number mean: 0.5000
//
//
//       Total random numbers generated: 22,000,000
//       Total sum of all random numbers: 11,000,067.33
//       Random number mean: 0.5000
``````
``````Imports System.Collections.Generic

Module Example
Dim source As New CancellationTokenSource()
Dim randLock As New Object()
Dim numericLock As New Object()
Dim rand As New Random()
Dim totalValue As Double = 0.0
Dim totalCount As Integer = 0

Public Sub Main()

For ctr As Integer = 1 To 10
Dim token As CancellationToken = source.Token
Dim taskNo As Integer = ctr
Sub()
Dim previous As Double = 0.0
Dim taskCtr As Integer = 0
Dim taskTotal As Double = 0.0
Dim result As Double = 0.0

For n As Integer = 1 To 2000000
' Make sure there's no corruption of Random.
token.ThrowIfCancellationRequested()

SyncLock randLock
result = rand.NextDouble()
End SyncLock
' Check for corruption of Random instance.
If result = previous AndAlso result = 0 Then
source.Cancel()
Else
previous = result
End If
Next

' Show result.
Console.WriteLine("Sum of random numbers: {0:N2}", taskTotal)
Console.WriteLine()

' Update overall totals.
SyncLock numericLock
End SyncLock
End Sub, token))
Next

Try
Console.WriteLine()
Console.WriteLine("Total random numbers generated: {0:N0}", totalCount)
Console.WriteLine("Total sum of all random numbers: {0:N2}", totalValue)
Console.WriteLine("Random number mean: {0:N4}", totalValue/totalCount)
Catch e As AggregateException
For Each inner As Exception In e.InnerExceptions
If canc IsNot Nothing Then
Else
Console.WriteLine("Exception: {0}", inner.GetType().Name)
End If
Next
Finally
source.Dispose()
End Try
End Sub
End Module
' The example displays output like the following:
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,502.47
'       Random number mean: 0.5003
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,445.63
'       Random number mean: 0.5002
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,556.04
'       Random number mean: 0.5003
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,178.87
'       Random number mean: 0.5001
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,819.17
'       Random number mean: 0.4999
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,190.58
'       Random number mean: 0.5001
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,720.21
'       Random number mean: 0.4999
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,000.96
'       Random number mean: 0.4995
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,499.33
'       Random number mean: 0.4997
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 1,000,193.25
'       Random number mean: 0.5001
'
'       Random numbers generated: 2,000,000
'       Sum of random numbers: 999,960.82
'       Random number mean: 0.5000
'
'
'       Total random numbers generated: 22,000,000
'       Total sum of all random numbers: 11,000,067.33
'       Random number mean: 0.5000
``````

Dies unterscheidet sich vom ersten Beispiel wie folgt:It differs from the first example in the following ways:

• Die Variablen, die die Anzahl der generierten Zufallszahlen und deren Summe in jeder Aufgabe nachverfolgen sollen, sind für die Aufgabe lokal, sodass es nicht erforderlich ist, das ThreadStaticAttribute-Attribut zu verwenden.The variables to keep track of the number of random numbers generated and their sum in each task are local to the task, so there is no need to use the ThreadStaticAttribute attribute.

• Die statische Task.WaitAll-Methode wird verwendet, um sicherzustellen, dass der Haupt Thread nicht vollständig abgeschlossen ist, bevor alle Aufgaben abgeschlossen sind.The static Task.WaitAll method is used to ensure that the main thread doesn't complete before all tasks have finished. Das CountdownEvent-Objekt ist nicht erforderlich.There is no need for the CountdownEvent object.

• Die Ausnahme, die sich aus dem Task Abbruch ergibt, wird in der Task.WaitAll-Methode angezeigt.The exception that results from task cancellation is surfaced in the Task.WaitAll method. Im vorherigen Beispiel wird Sie von jedem Thread behandelt.In the previous example, it is handled by each thread.

### Erstellen verschiedener Typen von ZufallszahlenGenerating different types of random numbers

Der Zufallszahlengenerator stellt Methoden bereit, mit denen Sie die folgenden Arten von Zufallszahlen generieren können:The random number generator provides methods that let you generate the following kinds of random numbers:

• Eine Reihe von Byte Werten.A series of Byte values. Sie bestimmen die Anzahl von Byte Werten, indem Sie ein Array, das an die Anzahl der Elemente initialisiert wird, die die Methode zurückgeben soll, an die NextBytes Methode übergeben.You determine the number of byte values by passing an array initialized to the number of elements you want the method to return to the NextBytes method. Im folgenden Beispiel werden 20 Bytes generiert.The following example generates 20 bytes.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
array<Byte>^ bytes = gcnew array<Byte>(20);
rnd->NextBytes(bytes);
for (int ctr = 1; ctr <= bytes->Length; ctr++) {
Console::Write("{0,3}   ", bytes[ctr - 1]);
if (ctr % 10 == 0) Console::WriteLine();
}
}
// The example displays output like the following:
//       141    48   189    66   134   212   211    71   161    56
//       181   166   220   133     9   252   222    57    62    62
``````
``````Random rnd = new Random();
Byte[] bytes = new Byte[20];
rnd.NextBytes(bytes);
for (int ctr = 1; ctr <= bytes.Length; ctr++) {
Console.Write("{0,3}   ", bytes[ctr - 1]);
if (ctr % 10 == 0) Console.WriteLine();
}

// The example displays output like the following:
//       141    48   189    66   134   212   211    71   161    56
//       181   166   220   133     9   252   222    57    62    62
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random()
Dim bytes(19) As Byte
rnd.NextBytes(bytes)
For ctr As Integer = 1 To bytes.Length
Console.Write("{0,3}   ", bytes(ctr - 1))
If ctr Mod 10 = 0 Then Console.WriteLine()
Next
End Sub
End Module
' The example displays output like the following:
'       141    48   189    66   134   212   211    71   161    56
'       181   166   220   133     9   252   222    57    62    62
``````
• Eine einzelne Ganzzahl.A single integer. Sie können auswählen, ob eine ganze Zahl zwischen 0 und einem maximalen Wert (Int32.MaxValue-1) werden soll, indem Sie die Next()-Methode aufrufen, eine ganze Zahl zwischen 0 und einem bestimmten Wert, indem Sie die Next(Int32)-Methode aufrufen, oder eine ganze Zahl innerhalb eines Wertebereichs, indem Sie die Next(Int32, Int32)-Methode aufrufen.You can choose whether you want an integer from 0 to a maximum value (Int32.MaxValue - 1) by calling the Next() method, an integer between 0 and a specific value by calling the Next(Int32) method, or an integer within a range of values by calling the Next(Int32, Int32) method. In den parametrisierten über Ladungen ist der angegebene Maximalwert exklusiv. Das heißt, die tatsächliche Höchstzahl, die generiert wird, ist ein kleiner als der angegebene Wert.In the parameterized overloads, the specified maximum value is exclusive; that is, the actual maximum number generated is one less than the specified value.

Im folgenden Beispiel wird die Next(Int32, Int32)-Methode aufgerufen, um 10 Zufallszahlen zwischen-10 und 10 zu generieren.The following example calls the Next(Int32, Int32) method to generate 10 random numbers between -10 and 10. Beachten Sie, dass das zweite Argument für die-Methode die exklusive obere Grenze des Bereichs von Zufalls Werten angibt, die von der-Methode zurückgegeben werden.Note that the second argument to the method specifies the exclusive upper bound of the range of random values returned by the method. Anders ausgedrückt: die größte Ganzzahl, die die Methode zurückgeben kann, ist ein kleiner als dieser Wert.In other words, the largest integer that the method can return is one less than this value.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
for (int ctr = 0; ctr < 10; ctr++) {
Console::Write("{0,3}   ", rnd->Next(-10, 11));
}
}
// The example displays output like the following:
//    2     9    -3     2     4    -7    -3    -8    -8     5
``````
``````Random rnd = new Random();
for (int ctr = 0; ctr < 10; ctr++) {
Console.Write("{0,3}   ", rnd.Next(-10, 11));
}

// The example displays output like the following:
//    2     9    -3     2     4    -7    -3    -8    -8     5
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random()
For ctr As Integer = 0 To 9
Console.Write("{0,3}   ", rnd.Next(-10, 11))
Next
End Sub
End Module
' The example displays output like the following:
'    2     9    -3     2     4    -7    -3    -8    -8     5
``````
• Ein einzelner Gleit Komma Wert zwischen 0,0 und kleiner als 1,0 durch Aufrufen der NextDouble-Methode.A single floating-point value from 0.0 to less than 1.0 by calling the NextDouble method. Die exklusive obere Grenze der Zufallszahl, die von der-Methode zurückgegeben wird, ist 1, sodass Ihre tatsächliche obere Grenze 0.99999999999999978 ist.The exclusive upper bound of the random number returned by the method is 1, so its actual upper bound is 0.99999999999999978. Im folgenden Beispiel werden 10 zufällige Gleit Komma Zahlen generiert.The following example generates 10 random floating-point numbers.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
for (int ctr = 0; ctr < 10; ctr++) {
Console::Write("{0,-19:R}   ", rnd->NextDouble());
if ((ctr + 1) % 3 == 0) Console::WriteLine();
}
}
// The example displays output like the following:
//    0.7911680553998649    0.0903414949264105    0.79776258291572455
//    0.615568345233597     0.652644504165577     0.84023809378977776
//    0.099662564741290441   0.91341467383942321  0.96018602045261581
//    0.74772306473354022
``````
``````Random rnd = new Random();
for (int ctr = 0; ctr < 10; ctr++) {
Console.Write("{0,-19:R}   ", rnd.NextDouble());
if ((ctr + 1) % 3 == 0) Console.WriteLine();
}

// The example displays output like the following:
//    0.7911680553998649    0.0903414949264105    0.79776258291572455
//    0.615568345233597     0.652644504165577     0.84023809378977776
//    0.099662564741290441   0.91341467383942321  0.96018602045261581
//    0.74772306473354022
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random()
For ctr As Integer = 0 To 9
Console.Write("{0,-19:R}   ", rnd.NextDouble())
If (ctr + 1) Mod 3 = 0 Then Console.WriteLine()
Next
End Sub
End Module
' The example displays output like the following:
'    0.7911680553998649    0.0903414949264105    0.79776258291572455
'    0.615568345233597     0.652644504165577     0.84023809378977776
'    0.099662564741290441  0.91341467383942321   0.96018602045261581
'    0.74772306473354022
``````

Wichtig

Die Next(Int32, Int32)-Methode ermöglicht es Ihnen, den Bereich der zurückgegebenen Zufallszahl anzugeben.The Next(Int32, Int32) method allows you to specify the range of the returned random number. Der `maxValue`-Parameter, der die zurückgegebene Zahl des oberen Bereichs angibt, ist jedoch ein exklusiver, kein inklusiver Wert.However, the `maxValue` parameter, which specifies the upper range returned number, is an exclusive, not an inclusive, value. Dies bedeutet, dass der Methoden Aufruf`Next(0, 100)` einen Wert zwischen 0 und 99 zurückgibt, nicht zwischen 0 und 100.This means that the method call `Next(0, 100)` returns a value between 0 and 99, and not between 0 and 100.

Sie können auch die Random-Klasse für Aufgaben wie das Erstellen zufälliger t:System.Boolean-Werte, das Erstellen zufälliger Gleit Komma Werte mit einem Bereich von 0 bis 1, das Erstellen zufälliger 64-Bit-Ganzzahlen und das Zufalls Abrufen eines eindeutigen Elements aus einem Array odereiner Auflistung verwenden.You can also use the Random class for such tasks as generating random T:System.Boolean values, generating random floating point values with a range other than 0 to 1, generating random 64-bit integers, and randomly retrieving a unique element from an array or collection. Informationen zu diesen und anderen häufigen Aufgaben finden Sie unter Gewusst wie: Verwenden von System. Random für.. .For these and other common tasks, see the How do you use System.Random to… abgerufen haben.section.

### Ersetzen Ihres eigenen AlgorithmusSubstituting your own algorithm

Sie können Ihren eigenen Zufallszahlen-Generator implementieren, indem Sie von der Random-Klasse erben und den Algorithmus für die Zufallszahlengenerierung bereitstellen.You can implement your own random number generator by inheriting from the Random class and supplying your random number generation algorithm. Um einen eigenen Algorithmus bereitzustellen, müssen Sie die Sample-Methode überschreiben, die den Algorithmus für die Zufallszahlengenerierung implementiert.To supply your own algorithm, you must override the Sample method, which implements the random number generation algorithm. Außerdem sollten Sie die Methoden Next(), Next(Int32, Int32)und NextBytes überschreiben, um sicherzustellen, dass Sie die überschriebene Sample-Methode aufzurufen.You should also override the Next(), Next(Int32, Int32), and NextBytes methods to ensure that they call your overridden Sample method. Sie müssen die Methoden Next(Int32) und NextDouble nicht überschreiben.You don't have to override the Next(Int32) and NextDouble methods.

Ein Beispiel, das von der Random-Klasse abgeleitet wird und den standardmäßigen Pseudozufallszahlen-Generator ändert, finden Sie auf der Sample Referenzseite.For an example that derives from the Random class and modifies its default pseudo-random number generator, see the Sample reference page.

### Verwendung von System. Random für...How do you use System.Random to…

In den folgenden Abschnitten wird der Beispielcode für einige Möglichkeiten erläutert und bereitgestellt, wie Sie in Ihrer APP Zufallszahlen verwenden können.The following sections discuss and provide sample code for some of the ways you might want to use random numbers in your app.

#### Abrufen der gleichen Sequenz von Zufalls WertenRetrieve the same sequence of random values

Manchmal möchten Sie die gleiche Sequenz von Zufallszahlen in Softwaretest Szenarien und in Spiel spielen generieren.Sometimes you want to generate the same sequence of random numbers in software test scenarios and in game playing. Durch Tests mit der gleichen Sequenz von Zufallszahlen können Sie Regressionen erkennen und Fehlerbehebungen bestätigen.Testing with the same sequence of random numbers allows you to detect regressions and confirm bug fixes. Die Verwendung derselben Sequenz von Zufallszahlen in spielen ermöglicht Ihnen, vorherige Spiele wiederzugeben.Using the same sequence of random number in games allows you to replay previous games.

Sie können dieselbe Sequenz von Zufallszahlen generieren, indem Sie dem Random(Int32)-Konstruktor denselben Ausgangswert bereitstellen.You can generate the same sequence of random numbers by providing the same seed value to the Random(Int32) constructor. Der Seed-Wert stellt einen Startwert für den Algorithmus zur Generierung von Pseudozufallszahlen dar.The seed value provides a starting value for the pseudo-random number generation algorithm. Im folgenden Beispiel wird 100100 als beliebiger Ausgangswert verwendet, um das Random-Objekt zu instanziieren, 20 zufällige Gleit Komma Werte anzeigt und den Seed-Wert persistent zu verwenden.The following example uses 100100 as an arbitrary seed value to instantiate the Random object, displays 20 random floating-point values, and persists the seed value. Anschließend wird der Seed-Wert wieder hergestellt, ein neuer Zufallszahlengenerator instanziiert und die gleichen 20 zufälligen Gleit Komma Werte angezeigt.It then restores the seed value, instantiates a new random number generator, and displays the same 20 random floating-point values. Beachten Sie, dass das Beispiel möglicherweise unterschiedliche Sequenzen von Zufallszahlen erzeugt, wenn Sie in verschiedenen Versionen der .NET Framework ausgeführt werden.Note that the example may produce different sequences of random numbers if run on different versions of the .NET Framework.

``````using namespace System;
using namespace System::IO;

ref class RandomMethods
{
internal:
static void ShowRandomNumbers(int seed)
{
Random^ rnd = gcnew Random(seed);
for (int ctr = 0; ctr <= 20; ctr++)
Console::WriteLine(rnd->NextDouble());
}

static void PersistSeed(int seed)
{
FileStream^ fs = gcnew FileStream(".\\seed.dat", FileMode::Create);
BinaryWriter^ bin = gcnew BinaryWriter(fs);
bin->Write(seed);
bin->Close();
}

static void DisplayNewRandomNumbers()
{
FileStream^ fs = gcnew FileStream(".\\seed.dat", FileMode::Open);
bin->Close();

Random^ rnd = gcnew Random(seed);
for (int ctr = 0; ctr <= 20; ctr++)
Console::WriteLine(rnd->NextDouble());
}
};

void main()
{
int seed = 100100;
RandomMethods::ShowRandomNumbers(seed);
Console::WriteLine();

RandomMethods::PersistSeed(seed);

RandomMethods::DisplayNewRandomNumbers();
}
// The example displays output like the following:
//       0.500193602172748
//       0.0209461245783354
//       0.465869495396442
//       0.195512794514891
//       0.928583675496552
//       0.729333720509584
//       0.381455668891527
//       0.0508996467343064
//       0.019261200921266
//       0.258578445417145
//       0.0177532266908107
//       0.983277184415272
//       0.483650274334313
//       0.0219647376900375
//       0.165910115077118
//       0.572085966622497
//       0.805291457942357
//       0.927985211335116
//       0.4228545699375
//       0.523320379910674
//       0.157783938645285
//
//       0.500193602172748
//       0.0209461245783354
//       0.465869495396442
//       0.195512794514891
//       0.928583675496552
//       0.729333720509584
//       0.381455668891527
//       0.0508996467343064
//       0.019261200921266
//       0.258578445417145
//       0.0177532266908107
//       0.983277184415272
//       0.483650274334313
//       0.0219647376900375
//       0.165910115077118
//       0.572085966622497
//       0.805291457942357
//       0.927985211335116
//       0.4228545699375
//       0.523320379910674
//       0.157783938645285
``````
``````using System;
using System.IO;

public class Example
{
public static void Main()
{
int seed = 100100;
ShowRandomNumbers(seed);
Console.WriteLine();

PersistSeed(seed);

DisplayNewRandomNumbers();
}

private static void ShowRandomNumbers(int seed)
{
Random rnd = new Random(seed);
for (int ctr = 0; ctr <= 20; ctr++)
Console.WriteLine(rnd.NextDouble());
}

private static void PersistSeed(int seed)
{
FileStream fs = new FileStream(@".\seed.dat", FileMode.Create);
BinaryWriter bin = new BinaryWriter(fs);
bin.Write(seed);
bin.Close();
}

private static void DisplayNewRandomNumbers()
{
FileStream fs = new FileStream(@".\seed.dat", FileMode.Open);
bin.Close();

Random rnd = new Random(seed);
for (int ctr = 0; ctr <= 20; ctr++)
Console.WriteLine(rnd.NextDouble());
}
}
// The example displays output like the following:
//       0.500193602172748
//       0.0209461245783354
//       0.465869495396442
//       0.195512794514891
//       0.928583675496552
//       0.729333720509584
//       0.381455668891527
//       0.0508996467343064
//       0.019261200921266
//       0.258578445417145
//       0.0177532266908107
//       0.983277184415272
//       0.483650274334313
//       0.0219647376900375
//       0.165910115077118
//       0.572085966622497
//       0.805291457942357
//       0.927985211335116
//       0.4228545699375
//       0.523320379910674
//       0.157783938645285
//
//       0.500193602172748
//       0.0209461245783354
//       0.465869495396442
//       0.195512794514891
//       0.928583675496552
//       0.729333720509584
//       0.381455668891527
//       0.0508996467343064
//       0.019261200921266
//       0.258578445417145
//       0.0177532266908107
//       0.983277184415272
//       0.483650274334313
//       0.0219647376900375
//       0.165910115077118
//       0.572085966622497
//       0.805291457942357
//       0.927985211335116
//       0.4228545699375
//       0.523320379910674
//       0.157783938645285
``````
``````Imports System.IO

Module Example
Public Sub Main()
Dim seed As Integer = 100100
ShowRandomNumbers(seed)
Console.WriteLine()

PersistSeed(seed)

DisplayNewRandomNumbers()
End Sub

Private Sub ShowRandomNumbers(seed As Integer)
Dim rnd As New Random(seed)
For ctr As Integer = 0 To 20
Console.WriteLine(rnd.NextDouble())
Next
End Sub

Private Sub PersistSeed(seed As Integer)
Dim fs As New FileStream(".\seed.dat", FileMode.Create)
Dim bin As New BinaryWriter(fs)
bin.Write(seed)
bin.Close()
End Sub

Private Sub DisplayNewRandomNumbers()
Dim fs As New FileStream(".\seed.dat", FileMode.Open)
Dim seed As Integer = bin.ReadInt32()
bin.Close()

Dim rnd As New Random(seed)
For ctr As Integer = 0 To 20
Console.WriteLine(rnd.NextDouble())
Next
End Sub
End Module
' The example displays output like the following:
'       0.500193602172748
'       0.0209461245783354
'       0.465869495396442
'       0.195512794514891
'       0.928583675496552
'       0.729333720509584
'       0.381455668891527
'       0.0508996467343064
'       0.019261200921266
'       0.258578445417145
'       0.0177532266908107
'       0.983277184415272
'       0.483650274334313
'       0.0219647376900375
'       0.165910115077118
'       0.572085966622497
'       0.805291457942357
'       0.927985211335116
'       0.4228545699375
'       0.523320379910674
'       0.157783938645285
'
'       0.500193602172748
'       0.0209461245783354
'       0.465869495396442
'       0.195512794514891
'       0.928583675496552
'       0.729333720509584
'       0.381455668891527
'       0.0508996467343064
'       0.019261200921266
'       0.258578445417145
'       0.0177532266908107
'       0.983277184415272
'       0.483650274334313
'       0.0219647376900375
'       0.165910115077118
'       0.572085966622497
'       0.805291457942357
'       0.927985211335116
'       0.4228545699375
'       0.523320379910674
'       0.157783938645285
``````

#### Abrufen von eindeutigen Sequenzen von ZufallszahlenRetrieve unique sequences of random numbers

Die Angabe unterschiedlicher Ausgangswerte für Instanzen der Random Klasse bewirkt, dass jeder Zufallszahlengenerator eine andere Sequenz von Werten erzeugt.Providing different seed values to instances of the Random class causes each random number generator to produce a different sequence of values. Sie können einen Ausgangswert entweder explizit angeben, indem Sie den Random(Int32)-Konstruktor aufrufen oder den Random()-Konstruktor implizit aufrufen.You can provide a seed value either explicitly by calling the Random(Int32) constructor, or implicitly by calling the Random() constructor. Die meisten Entwickler wenden den Parameter losen Konstruktor an, der die Systemuhr verwendet.Most developers call the parameterless constructor, which uses the system clock. Im folgenden Beispiel wird dieser Ansatz verwendet, um zwei Random Instanzen zu instanziieren.The following example uses this approach to instantiate two Random instances. Jede Instanz zeigt eine Reihe von 10 zufälligen Ganzzahlen an.Each instance displays a series of 10 random integers.

``````using namespace System;

void main()
{
Console::WriteLine("Instantiating two random number generators...");
Random^ rnd1 = gcnew Random();
Random^ rnd2 = gcnew Random();

Console::WriteLine("\nThe first random number generator:");
for (int ctr = 1; ctr <= 10; ctr++)
Console::WriteLine("   {0}", rnd1->Next());

Console::WriteLine("\nThe second random number generator:");
for (int ctr = 1; ctr <= 10; ctr++)
Console::WriteLine("   {0}", rnd2->Next());
}
// The example displays output like the following:
//       Instantiating two random number generators...
//
//       The first random number generator:
//          643164361
//          1606571630
//          1725607587
//          2138048432
//          496874898
//          1969147632
//          2034533749
//          1840964542
//          412380298
//          47518930
//
//       The second random number generator:
//          1251659083
//          1514185439
//          1465798544
//          517841554
//          1821920222
//          195154223
//          1538948391
//          1548375095
//          546062716
//          897797880
``````
``````using System;

public class Example
{
public static void Main()
{
Console.WriteLine("Instantiating two random number generators...");
Random rnd1 = new Random();
Random rnd2 = new Random();

Console.WriteLine("\nThe first random number generator:");
for (int ctr = 1; ctr <= 10; ctr++)
Console.WriteLine("   {0}", rnd1.Next());

Console.WriteLine("\nThe second random number generator:");
for (int ctr = 1; ctr <= 10; ctr++)
Console.WriteLine("   {0}", rnd2.Next());
}
}
// The example displays output like the following:
//       Instantiating two random number generators...
//
//       The first random number generator:
//          643164361
//          1606571630
//          1725607587
//          2138048432
//          496874898
//          1969147632
//          2034533749
//          1840964542
//          412380298
//          47518930
//
//       The second random number generator:
//          1251659083
//          1514185439
//          1465798544
//          517841554
//          1821920222
//          195154223
//          1538948391
//          1548375095
//          546062716
//          897797880
``````
``````Imports System.Threading

Module Example
Public Sub Main()
Console.WriteLine("Instantiating two random number generators...")
Dim rnd1 As New Random()
Dim rnd2 As New Random()
Console.WriteLine()

Console.WriteLine("The first random number generator:")
For ctr As Integer = 1 To 10
Console.WriteLine("   {0}", rnd1.Next())
Next
Console.WriteLine()

Console.WriteLine("The second random number generator:")
For ctr As Integer = 1 To 10
Console.WriteLine("   {0}", rnd2.Next())
Next
End Sub
End Module
' The example displays output like the following:
'       Instantiating two random number generators...
'
'       The first random number generator:
'          643164361
'          1606571630
'          1725607587
'          2138048432
'          496874898
'          1969147632
'          2034533749
'          1840964542
'          412380298
'          47518930
'
'       The second random number generator:
'          1251659083
'          1514185439
'          1465798544
'          517841554
'          1821920222
'          195154223
'          1538948391
'          1548375095
'          546062716
'          897797880
``````

Aufgrund der begrenzten Auflösung erkennt die Systemuhr jedoch keine Zeitunterschiede, die weniger als ungefähr 15 Millisekunden betragen.However, because of its finite resolution, the system clock doesn't detect time differences that are less than approximately 15 milliseconds. Wenn Ihr Code die Random() Überladung auf dem .NET Framework aufruft, um zwei Random Objekte nacheinander zu instanziieren, können Sie daher versehentlich die Objekte mit identischen Ausgangswerten bereitstellen.Therefore, if your code calls the Random() overload on the .NET Framework to instantiate two Random objects in succession, you might inadvertently be providing the objects with identical seed values. (Für die Random-Klasse in .net Core gibt es diese Einschränkung nicht.) Um dies im vorherigen Beispiel zu sehen, kommentieren Sie den Thread.Sleep-Methodenaufrufe aus, und kompilieren Sie das Beispiel, und führen Sie es erneut aus.(The Random class in .NET Core does not have this limitation.) To see this in the previous example, comment out the Thread.Sleep method call, and compile and run the example again.

Um dies zu verhindern, empfiehlt es sich, ein einzelnes Random Objekt anstelle mehrerer Objekte zu instanziieren.To prevent this from happening, we recommend that you instantiate a single Random object rather than multiple ones. Da Random jedoch nicht Thread sicher ist, müssen Sie ein Synchronisierungs Gerät verwenden, wenn Sie von mehreren Threads aus auf eine Random Instanz zugreifen. Weitere Informationen finden Sie unter Random class and Thread Safety weiter oben in diesem Thema.However, since Random isn't thread safe, you must use some synchronization device if you access a Random instance from multiple threads; for more information, see The Random class and thread safety earlier in this topic. Alternativ können Sie einen Verzögerungs Mechanismus verwenden, wie z. b. die Sleep-Methode, die im vorherigen Beispiel verwendet wurde, um sicherzustellen, dass die Instanziierungen mehr als 15 Millisekunden voneinander getrennt vorkommen.Alternately, you can use a delay mechanism, such as the Sleep method used in the previous example, to ensure that the instantiations occur more than 15 millisecond apart.

#### Abrufen von ganzen Zahlen in einem angegebenen BereichRetrieve integers in a specified range

Sie können ganze Zahlen in einem angegebenen Bereich abrufen, indem Sie die Next(Int32, Int32)-Methode aufrufen, mit der Sie sowohl die untere als auch die obere Grenze der Zahlen festlegen können, die der Zufallszahlengenerator zurückgeben soll.You can retrieve integers in a specified range by calling the Next(Int32, Int32) method, which lets you specify both the lower and the upper bound of the numbers you'd like the random number generator to return. Die obere Grenze ist ein exklusiver, kein inklusiver Wert.The upper bound is an exclusive, not an inclusive, value. Das heißt, es ist nicht in den von der-Methode zurückgegebenen Wertebereich enthalten.That is, it isn't included in the range of values returned by the method. Im folgenden Beispiel wird diese Methode verwendet, um zufällige ganze Zahlen zwischen-10 und 10 zu generieren.The following example uses this method to generate random integers between -10 and 10. Beachten Sie, dass es 11 angibt, das einen größer als der gewünschte Wert ist, als Wert des `maxValue` Arguments im Methoden Aufruf.Note that it specifies 11, which is one greater than the desired value, as the value of the `maxValue` argument in the method call.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
for (int ctr = 1; ctr <= 15; ctr++) {
Console::Write("{0,3}    ", rnd->Next(-10, 11));
if(ctr % 5 == 0) Console::WriteLine();
}
}
// The example displays output like the following:
//        -2     -5     -1     -2     10
//        -3      6     -4     -8      3
//        -7     10      5     -2      4
``````
``````Random rnd = new Random();
for (int ctr = 1; ctr <= 15; ctr++) {
Console.Write("{0,3}    ", rnd.Next(-10, 11));
if(ctr % 5 == 0) Console.WriteLine();
}

// The example displays output like the following:
//        -2     -5     -1     -2     10
//        -3      6     -4     -8      3
//        -7     10      5     -2      4
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random()
For ctr As Integer = 1 To 15
Console.Write("{0,3}    ", rnd.Next(-10, 11))
If ctr Mod 5 = 0 Then Console.WriteLine()
Next
End Sub
End Module
' The example displays output like the following:
'        -2     -5     -1     -2     10
'        -3      6     -4     -8      3
'        -7     10      5     -2      4
``````

#### Ganze Zahlen mit einer angegebenen Anzahl von Ziffern abrufenRetrieve integers with a specified number of digits

Sie können die Next(Int32, Int32)-Methode aufrufen, um Zahlen mit einer bestimmten Anzahl von Ziffern abzurufen.You can call the Next(Int32, Int32) method to retrieve numbers with a specified number of digits. Wenn Sie z. b. Zahlen mit vier Ziffern (d. h. Zahlen zwischen 1000 und 9999) abrufen möchten, rufen Sie die Next(Int32, Int32)-Methode mit dem `minValue` Wert 1000 und dem `maxValue` Wert 10000 auf, wie im folgenden Beispiel gezeigt.For example, to retrieve numbers with four digits (that is, numbers that range from 1000 to 9999), you call the Next(Int32, Int32) method with a `minValue` value of 1000 and a `maxValue` value of 10000, as the following example shows.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
for (int ctr = 1; ctr <= 50; ctr++) {
Console::Write("{0,3}   ", rnd->Next(1000, 10000));
if(ctr % 10 == 0) Console::WriteLine();
}
}
// The example displays output like the following:
//    9570    8979    5770    1606    3818    4735    8495    7196    7070    2313
//    5279    6577    5104    5734    4227    3373    7376    6007    8193    5540
//    7558    3934    3819    7392    1113    7191    6947    4963    9179    7907
//    3391    6667    7269    1838    7317    1981    5154    7377    3297    5320
//    9869    8694    2684    4949    2999    3019    2357    5211    9604    2593
``````
``````Random rnd = new Random();
for (int ctr = 1; ctr <= 50; ctr++) {
Console.Write("{0,3}    ", rnd.Next(1000, 10000));
if(ctr % 10 == 0) Console.WriteLine();
}

// The example displays output like the following:
//    9570    8979    5770    1606    3818    4735    8495    7196    7070    2313
//    5279    6577    5104    5734    4227    3373    7376    6007    8193    5540
//    7558    3934    3819    7392    1113    7191    6947    4963    9179    7907
//    3391    6667    7269    1838    7317    1981    5154    7377    3297    5320
//    9869    8694    2684    4949    2999    3019    2357    5211    9604    2593
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random()
For ctr As Integer = 1 To 50
Console.Write("{0,3}    ", rnd.Next(1000, 10000))
If ctr Mod 10 = 0 Then Console.WriteLine()
Next
End Sub
End Module
' The example displays output like the following:
'    9570    8979    5770    1606    3818    4735    8495    7196    7070    2313
'    5279    6577    5104    5734    4227    3373    7376    6007    8193    5540
'    7558    3934    3819    7392    1113    7191    6947    4963    9179    7907
'    3391    6667    7269    1838    7317    1981    5154    7377    3297    5320
'    9869    8694    2684    4949    2999    3019    2357    5211    9604    2593
``````

#### Abrufen von Gleit Komma Werten in einem angegebenen BereichRetrieve floating-point values in a specified range

Die NextDouble-Methode gibt zufällige Gleit Komma Werte zurück, die zwischen 0 und kleiner als 1 liegen.The NextDouble method returns random floating-point values that range from 0 to less than 1. Sie möchten jedoch häufig Zufallswerte in einem anderen Bereich generieren.However, you'll often want to generate random values in some other range.

Wenn das Intervall zwischen dem minimalen und dem maximalen gewünschten Wert 1 beträgt, können Sie den Unterschied zwischen dem gewünschten Start Intervall und 0 der von der NextDouble-Methode zurückgegebenen Zahl hinzufügen.If the interval between the minimum and maximum desired values is 1, you can add the difference between the desired starting interval and 0 to the number returned by the NextDouble method. Im folgenden Beispiel werden 10 Zufallszahlen zwischen-1 und 0 generiert.The following example does this to generate 10 random numbers between -1 and 0.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
for (int ctr = 1; ctr <= 10; ctr++)
Console::WriteLine(rnd->NextDouble() - 1);
}
// The example displays output like the following:
//       -0.930412760437658
//       -0.164699016215605
//       -0.9851692803135
//       -0.43468508843085
//       -0.177202483255976
//       -0.776813320245972
//       -0.0713201854710096
//       -0.0912875561468711
//       -0.540621722368813
//       -0.232211863730201
``````
``````Random rnd = new Random();
for (int ctr = 1; ctr <= 10; ctr++)
Console.WriteLine(rnd.NextDouble() - 1);

// The example displays output like the following:
//       -0.930412760437658
//       -0.164699016215605
//       -0.9851692803135
//       -0.43468508843085
//       -0.177202483255976
//       -0.776813320245972
//       -0.0713201854710096
//       -0.0912875561468711
//       -0.540621722368813
//       -0.232211863730201
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random()
For ctr As Integer = 1 To 10
Console.WriteLine(rnd.NextDouble() - 1)
Next
End Sub
End Module
' The example displays output like the following:
'       -0.930412760437658
'       -0.164699016215605
'       -0.9851692803135
'       -0.43468508843085
'       -0.177202483255976
'       -0.776813320245972
'       -0.0713201854710096
'       -0.0912875561468711
'       -0.540621722368813
'       -0.232211863730201
``````

Um zufällige Gleit Komma Zahlen zu generieren, deren untere Grenze 0 (null) ist, aber obere Grenze größer als 1 ist (oder im Fall von negativen Zahlen, deren untere Grenze kleiner als-1 und die obere Grenze 0 ist), Multiplizieren Sie die Zufallszahl mit der Grenze ungleich 0 (null).To generate random floating-point numbers whose lower bound is 0 but upper bound is greater than 1 (or, in the case of negative numbers, whose lower bound is less than -1 and upper bound is 0), multiply the random number by the non-zero bound. Im folgenden Beispiel werden 20 Millionen zufällige Gleit Komma Zahlen generiert, die zwischen 0 und Int64.MaxValueliegen.The following example does this to generate 20 million random floating-point numbers that range from 0 to Int64.MaxValue. In wird auch die Verteilung der von der-Methode generierten zufälligen Werte angezeigt.In also displays the distribution of the random values generated by the method.

``````using namespace System;

void main()
{
const Int64 ONE_TENTH = 922337203685477581;
Random^ rnd = gcnew Random();
double number;
array<int>^ count = gcnew array<int>(10);

// Generate 20 million integer values between.
for (int ctr = 1; ctr <= 20000000; ctr++) {
number = rnd->NextDouble() * Int64::MaxValue;
// Categorize random numbers into 10 groups.
int value = (int) (number / ONE_TENTH);
count[value]++;
}

// Display breakdown by range.
Console::WriteLine("{0,28} {1,32}   {2,7}\n", "Range", "Count", "Pct.");
for (int ctr = 0; ctr <= 9; ctr++)
Console::WriteLine("{0,25:N0}-{1,25:N0}  {2,8:N0}   {3,7:P2}", ctr * ONE_TENTH,
ctr < 9 ? ctr * ONE_TENTH + ONE_TENTH - 1 : Int64::MaxValue,
count[ctr], count[ctr]/20000000.0);
}
// The example displays output like the following:
//                           Range                            Count      Pct.
//
//                            0-  922,337,203,685,477,580  1,996,148    9.98 %
//      922,337,203,685,477,581-1,844,674,407,370,955,161  2,000,293   10.00 %
//    1,844,674,407,370,955,162-2,767,011,611,056,432,742  2,000,094   10.00 %
//    2,767,011,611,056,432,743-3,689,348,814,741,910,323  2,000,159   10.00 %
//    3,689,348,814,741,910,324-4,611,686,018,427,387,904  1,999,552   10.00 %
//    4,611,686,018,427,387,905-5,534,023,222,112,865,485  1,998,248    9.99 %
//    5,534,023,222,112,865,486-6,456,360,425,798,343,066  2,000,696   10.00 %
//    6,456,360,425,798,343,067-7,378,697,629,483,820,647  2,001,637   10.01 %
//    7,378,697,629,483,820,648-8,301,034,833,169,298,228  2,002,870   10.01 %
//    8,301,034,833,169,298,229-9,223,372,036,854,775,807  2,000,303   10.00 %
``````
``````const long ONE_TENTH = 922337203685477581;

Random rnd = new Random();
double number;
int[] count = new int[10];

// Generate 20 million integer values between.
for (int ctr = 1; ctr <= 20000000; ctr++) {
number = rnd.NextDouble() * Int64.MaxValue;
// Categorize random numbers into 10 groups.
count[(int) (number / ONE_TENTH)]++;
}
// Display breakdown by range.
Console.WriteLine("{0,28} {1,32}   {2,7}\n", "Range", "Count", "Pct.");
for (int ctr = 0; ctr <= 9; ctr++)
Console.WriteLine("{0,25:N0}-{1,25:N0}  {2,8:N0}   {3,7:P2}", ctr * ONE_TENTH,
ctr < 9 ? ctr * ONE_TENTH + ONE_TENTH - 1 : Int64.MaxValue,
count[ctr], count[ctr]/20000000.0);

// The example displays output like the following:
//                           Range                            Count      Pct.
//
//                            0-  922,337,203,685,477,580  1,996,148    9.98 %
//      922,337,203,685,477,581-1,844,674,407,370,955,161  2,000,293   10.00 %
//    1,844,674,407,370,955,162-2,767,011,611,056,432,742  2,000,094   10.00 %
//    2,767,011,611,056,432,743-3,689,348,814,741,910,323  2,000,159   10.00 %
//    3,689,348,814,741,910,324-4,611,686,018,427,387,904  1,999,552   10.00 %
//    4,611,686,018,427,387,905-5,534,023,222,112,865,485  1,998,248    9.99 %
//    5,534,023,222,112,865,486-6,456,360,425,798,343,066  2,000,696   10.00 %
//    6,456,360,425,798,343,067-7,378,697,629,483,820,647  2,001,637   10.01 %
//    7,378,697,629,483,820,648-8,301,034,833,169,298,228  2,002,870   10.01 %
//    8,301,034,833,169,298,229-9,223,372,036,854,775,807  2,000,303   10.00 %
``````
``````Module Example
Public Sub Main()
Const ONE_TENTH As Long = 922337203685477581

Dim rnd As New Random()
Dim number As Long
Dim count(9) As Integer

' Generate 20 million integer values.
For ctr As Integer = 1 To 20000000
number = CLng(rnd.NextDouble() * Int64.MaxValue)
' Categorize random numbers.
count(CInt(number \ ONE_TENTH)) += 1
Next
' Display breakdown by range.
Console.WriteLine("{0,28} {1,32}   {2,7}", "Range", "Count", "Pct.")
Console.WriteLine()
For ctr As Integer = 0 To 9
Console.WriteLine("{0,25:N0}-{1,25:N0}  {2,8:N0}   {3,7:P2}", ctr * ONE_TENTH,
If(ctr < 9, ctr * ONE_TENTH + ONE_TENTH - 1, Int64.MaxValue),
count(ctr), count(ctr)/20000000)
Next
End Sub
End Module
' The example displays output like the following:
'                           Range                            Count      Pct.
'
'                            0-  922,337,203,685,477,580  1,996,148    9.98 %
'      922,337,203,685,477,581-1,844,674,407,370,955,161  2,000,293   10.00 %
'    1,844,674,407,370,955,162-2,767,011,611,056,432,742  2,000,094   10.00 %
'    2,767,011,611,056,432,743-3,689,348,814,741,910,323  2,000,159   10.00 %
'    3,689,348,814,741,910,324-4,611,686,018,427,387,904  1,999,552   10.00 %
'    4,611,686,018,427,387,905-5,534,023,222,112,865,485  1,998,248    9.99 %
'    5,534,023,222,112,865,486-6,456,360,425,798,343,066  2,000,696   10.00 %
'    6,456,360,425,798,343,067-7,378,697,629,483,820,647  2,001,637   10.01 %
'    7,378,697,629,483,820,648-8,301,034,833,169,298,228  2,002,870   10.01 %
'    8,301,034,833,169,298,229-9,223,372,036,854,775,807  2,000,303   10.00 %
``````

Verwenden Sie die folgende Formel, um zufällige Gleit Komma Zahlen zwischen zwei beliebigen Werten zu generieren, wie z. b. die Next(Int32, Int32)-Methode für ganze Zahlen.To generate random floating-point numbers between two arbitrary values, like the Next(Int32, Int32) method does for integers, use the following formula:

``````Random.NextDouble() * (maxValue - minValue) + minValue
``````

Im folgenden Beispiel werden 1 Million Zufallszahlen generiert, die zwischen 10,0 und 11,0 liegen und deren Verteilung anzeigt.The following example generates 1 million random numbers that range from 10.0 to 11.0, and displays their distribution.

``````using namespace System;

void main()
{
Random^ rnd = gcnew Random();
int lowerBound = 10;
int upperBound = 11;
array<int>^ range = gcnew array<int>(10);
for (int ctr = 1; ctr <= 1000000; ctr++) {
Double value = rnd->NextDouble() * (upperBound - lowerBound) + lowerBound;
range[(int) Math::Truncate((value - lowerBound) * 10)]++;
}

for (int ctr = 0; ctr <= 9; ctr++) {
Double lowerRange = 10 + ctr * .1;
Console::WriteLine("{0:N1} to {1:N1}: {2,8:N0}  ({3,7:P2})",
lowerRange, lowerRange + .1, range[ctr],
range[ctr] / 1000000.0);
}
}
// The example displays output like the following:
//       10.0 to 10.1:   99,929  ( 9.99 %)
//       10.1 to 10.2:  100,189  (10.02 %)
//       10.2 to 10.3:   99,384  ( 9.94 %)
//       10.3 to 10.4:  100,240  (10.02 %)
//       10.4 to 10.5:   99,397  ( 9.94 %)
//       10.5 to 10.6:  100,580  (10.06 %)
//       10.6 to 10.7:  100,293  (10.03 %)
//       10.7 to 10.8:  100,135  (10.01 %)
//       10.8 to 10.9:   99,905  ( 9.99 %)
//       10.9 to 11.0:   99,948  ( 9.99 %)
``````
``````Random rnd = new Random();
int lowerBound = 10;
int upperBound = 11;
int[] range = new int[10];
for (int ctr = 1; ctr <= 1000000; ctr++) {
Double value = rnd.NextDouble() * (upperBound - lowerBound) + lowerBound;
range[(int) Math.Truncate((value - lowerBound) * 10)]++;
}

for (int ctr = 0; ctr <= 9; ctr++) {
Double lowerRange = 10 + ctr * .1;
Console.WriteLine("{0:N1} to {1:N1}: {2,8:N0}  ({3,7:P2})",
lowerRange, lowerRange + .1, range[ctr],
range[ctr] / 1000000.0);
}

// The example displays output like the following:
//       10.0 to 10.1:   99,929  ( 9.99 %)
//       10.1 to 10.2:  100,189  (10.02 %)
//       10.2 to 10.3:   99,384  ( 9.94 %)
//       10.3 to 10.4:  100,240  (10.02 %)
//       10.4 to 10.5:   99,397  ( 9.94 %)
//       10.5 to 10.6:  100,580  (10.06 %)
//       10.6 to 10.7:  100,293  (10.03 %)
//       10.7 to 10.8:  100,135  (10.01 %)
//       10.8 to 10.9:   99,905  ( 9.99 %)
//       10.9 to 11.0:   99,948  ( 9.99 %)
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random()
Dim lowerBound As Integer = 10
Dim upperBound As Integer = 11
Dim range(9) As Integer
For ctr As Integer = 1 To 1000000
Dim value As Double = rnd.NextDouble() * (upperBound - lowerBound) + lowerBound
range(CInt(Math.Truncate((value - lowerBound) * 10))) += 1
Next

For ctr As Integer = 0 To 9
Dim lowerRange As Double = 10 + ctr * .1
Console.WriteLine("{0:N1} to {1:N1}: {2,8:N0}  ({3,7:P2})",
lowerRange, lowerRange + .1, range(ctr),
range(ctr) / 1000000.0)
Next
End Sub
End Module
' The example displays output like the following:
'       10.0 to 10.1:   99,929  ( 9.99 %)
'       10.1 to 10.2:  100,189  (10.02 %)
'       10.2 to 10.3:   99,384  ( 9.94 %)
'       10.3 to 10.4:  100,240  (10.02 %)
'       10.4 to 10.5:   99,397  ( 9.94 %)
'       10.5 to 10.6:  100,580  (10.06 %)
'       10.6 to 10.7:  100,293  (10.03 %)
'       10.7 to 10.8:  100,135  (10.01 %)
'       10.8 to 10.9:   99,905  ( 9.99 %)
'       10.9 to 11.0:   99,948  ( 9.99 %)
``````

#### Generieren von zufälligen booleschen WertenGenerate random Boolean values

Die Random-Klasse stellt keine Methoden bereit, die Boolean Werte generieren.The Random class doesn't provide methods that generate Boolean values. Hierfür können Sie jedoch auch eine eigene Klasse oder Methode definieren.However, you can define your own class or method to do that. Im folgenden Beispiel wird eine-Klasse, `BooleanGenerator`mit einer einzelnen Methode definiert, `NextBoolean`.The following example defines a class, `BooleanGenerator`, with a single method, `NextBoolean`. Die `BooleanGenerator`-Klasse speichert ein Random-Objekt als private Variable.The `BooleanGenerator` class stores a Random object as a private variable. Die `NextBoolean`-Methode ruft die Random.Next(Int32, Int32)-Methode auf und übergibt das Ergebnis an die Convert.ToBoolean(Int32)-Methode.The `NextBoolean` method calls the Random.Next(Int32, Int32) method and passes the result to the Convert.ToBoolean(Int32) method. Beachten Sie, dass 2 als Argument verwendet wird, um die obere Grenze der Zufallszahl anzugeben.Note that 2 is used as the argument to specify the upper bound of the random number. Da dies ein exklusiver Wert ist, gibt der Methodenaufrufe entweder 0 oder 1 zurück.Since this is an exclusive value, the method call returns either 0 or 1.

``````using namespace System;

public ref class BooleanGenerator
{
private:
Random^ rnd;

public:
BooleanGenerator()
{
rnd = gcnew Random();
}

bool NextBoolean()
{
return Convert::ToBoolean(rnd->Next(0, 2));
}
};

void main()
{
// Instantiate the Boolean generator.
BooleanGenerator^ boolGen = gcnew BooleanGenerator();
int totalTrue = 0, totalFalse = 0;

// Generate 1,0000 random Booleans, and keep a running total.
for (int ctr = 0; ctr < 1000000; ctr++) {
bool value = boolGen->NextBoolean();
if (value)
totalTrue++;
else
totalFalse++;
}
Console::WriteLine("Number of true values:  {0,7:N0} ({1:P3})",
totalTrue,
((double) totalTrue)/(totalTrue + totalFalse));
Console::WriteLine("Number of false values: {0,7:N0} ({1:P3})",
totalFalse,
((double) totalFalse)/(totalTrue + totalFalse));
}

// The example displays output like the following:
//       Number of true values:  500,004 (50.000 %)
//       Number of false values: 499,996 (50.000 %)
``````
``````using System;

public class Example
{
public static void Main()
{
// Instantiate the Boolean generator.
BooleanGenerator boolGen = new BooleanGenerator();
int totalTrue = 0, totalFalse = 0;

// Generate 1,0000 random Booleans, and keep a running total.
for (int ctr = 0; ctr < 1000000; ctr++) {
bool value = boolGen.NextBoolean();
if (value)
totalTrue++;
else
totalFalse++;
}
Console.WriteLine("Number of true values:  {0,7:N0} ({1:P3})",
totalTrue,
((double) totalTrue)/(totalTrue + totalFalse));
Console.WriteLine("Number of false values: {0,7:N0} ({1:P3})",
totalFalse,
((double) totalFalse)/(totalTrue + totalFalse));
}
}

public class BooleanGenerator
{
Random rnd;

public BooleanGenerator()
{
rnd = new Random();
}

public bool NextBoolean()
{
return Convert.ToBoolean(rnd.Next(0, 2));
}
}
// The example displays output like the following:
//       Number of true values:  500,004 (50.000 %)
//       Number of false values: 499,996 (50.000 %)
``````
``````Module Example
Public Sub Main()
' Instantiate the Boolean generator.
Dim boolGen As New BooleanGenerator()
Dim totalTrue, totalFalse As Integer

' Generate 1,0000 random Booleans, and keep a running total.
For ctr As Integer = 0 To 9999999
Dim value As Boolean = boolGen.NextBoolean()
If value Then
totalTrue += 1
Else
totalFalse += 1
End If
Next
Console.WriteLine("Number of true values:  {0,7:N0} ({1:P3})",
totalTrue,
totalTrue/(totalTrue + totalFalse))
Console.WriteLine("Number of false values: {0,7:N0} ({1:P3})",
totalFalse,
totalFalse/(totalTrue + totalFalse))
End Sub
End Module

Public Class BooleanGenerator
Dim rnd As Random

Public Sub New()
rnd = New Random()
End Sub

Public Function NextBoolean() As Boolean
Return Convert.ToBoolean(rnd.Next(0, 2))
End Function
End Class
' The example displays the following output:
'       Number of true values:  500,004 (50.000 %)
'       Number of false values: 499,996 (50.000 %)
``````

Anstatt eine separate Klasse zum Generieren von zufälligen Boolean Werten zu erstellen, könnte das Beispiel einfach nur eine einzige Methode definieren.Instead of creating a separate class to generate random Boolean values, the example could simply have defined a single method. In diesem Fall sollte das Random Objekt jedoch als Variable auf Klassenebene definiert worden sein, um zu vermeiden, dass in jedem Methoden aufrufeine neue Random Instanz instanziiert wird.In that case, however, the Random object should have been defined as a class-level variable to avoid instantiating a new Random instance in each method call. In Visual Basic kann die zufällige Instanz als statische Variable in der `NextBoolean`-Methode definiert werden.In Visual Basic, the Random instance can be defined as a Static variable in the `NextBoolean` method. Im folgenden Beispiel wird eine-Implementierung bereitstellt.The following example provides an implementation.

``````using namespace System;

ref class Example
{
private:
static Random^ rnd = gcnew Random();

public:
static void Execute()
{
int totalTrue = 0, totalFalse = 0;

// Generate 1,0000 random Booleans, and keep a running total.
for (int ctr = 0; ctr < 1000000; ctr++) {
bool value = NextBoolean();
if (value)
totalTrue++;
else
totalFalse++;
}
Console::WriteLine("Number of true values:  {0,7:N0} ({1:P3})",
totalTrue,
((double) totalTrue)/(totalTrue + totalFalse));
Console::WriteLine("Number of false values: {0,7:N0} ({1:P3})",
totalFalse,
((double) totalFalse)/(totalTrue + totalFalse));
}

static bool NextBoolean()
{
return Convert::ToBoolean(rnd->Next(0, 2));
}
};

void main()
{
Example::Execute();
}
// The example displays output like the following:
//       Number of true values:  499,777 (49.978 %)
//       Number of false values: 500,223 (50.022 %)
``````
``````Random rnd = new Random();

int totalTrue = 0, totalFalse = 0;

// Generate 1,000,000 random Booleans, and keep a running total.
for (int ctr = 0; ctr < 1000000; ctr++) {
bool value = NextBoolean();
if (value)
totalTrue++;
else
totalFalse++;
}
Console.WriteLine("Number of true values:  {0,7:N0} ({1:P3})",
totalTrue,
((double) totalTrue)/(totalTrue + totalFalse));
Console.WriteLine("Number of false values: {0,7:N0} ({1:P3})",
totalFalse,
((double) totalFalse)/(totalTrue + totalFalse));

bool NextBoolean()
{
return Convert.ToBoolean(rnd.Next(0, 2));
}

// The example displays output like the following:
//       Number of true values:  499,777 (49.978 %)
//       Number of false values: 500,223 (50.022 %)
``````
``````Module Example
Public Sub Main()
Dim totalTrue, totalFalse As Integer

' Generate 1,0000 random Booleans, and keep a running total.
For ctr As Integer = 0 To 9999999
Dim value As Boolean = NextBoolean()
If value Then
totalTrue += 1
Else
totalFalse += 1
End If
Next
Console.WriteLine("Number of true values:  {0,7:N0} ({1:P3})",
totalTrue,
totalTrue/(totalTrue + totalFalse))
Console.WriteLine("Number of false values: {0,7:N0} ({1:P3})",
totalFalse,
totalFalse/(totalTrue + totalFalse))
End Sub

Public Function NextBoolean() As Boolean
Static rnd As New Random()
Return Convert.ToBoolean(rnd.Next(0, 2))
End Function
End Module
' The example displays the following output:
'       Number of true values:  499,777 (49.978 %)
'       Number of false values: 500,223 (50.022 %)
``````

#### Generieren zufälliger 64-Bit-GanzzahlenGenerate random 64-bit integers

Die über Ladungen der Next-Methode geben 32-Bit-Ganzzahlen zurück.The overloads of the Next method return 32-bit integers. In einigen Fällen möchten Sie jedoch vielleicht mit 64-Bit-Ganzzahlen arbeiten.However, in some cases, you might want to work with 64-bit integers. Gehen Sie hierzu folgendermaßen vor:You can do this as follows:

1. Rufen Sie die NextDouble-Methode auf, um einen Gleit Komma Wert mit doppelter Genauigkeit abzurufen.Call the NextDouble method to retrieve a double-precision floating point value.

2. Multiplizieren Sie diesen Wert Int64.MaxValue.Multiply that value by Int64.MaxValue.

Im folgenden Beispiel wird dieses Verfahren verwendet, um zufällige ganze Zahlen mit 20 Millionen zu generieren und in 10 gleich großen Gruppen zu kategorisieren.The following example uses this technique to generate 20 million random long integers and categorizes them in 10 equal groups. Anschließend wertet er die Verteilung der Zufallszahlen aus, indem er die Anzahl der einzelnen Gruppen von 0 bis Int64.MaxValuezählt.It then evaluates the distribution of the random numbers by counting the number in each group from 0 to Int64.MaxValue. Wie die Ausgabe des Beispiels zeigt, werden die Zahlen mehr oder weniger gleichmäßig über den Bereich einer langen ganzen Zahl verteilt.As the output from the example shows, the numbers are distributed more or less equally through the range of a long integer.

``````using namespace System;

void main()
{
const Int64 ONE_TENTH = 922337203685477581;

Random^ rnd = gcnew Random();
Int64 number;
array<int>^ count = gcnew array<int>(10);

// Generate 20 million long integers.
for (int ctr = 1; ctr <= 20000000; ctr++) {
number = (Int64) (rnd->NextDouble() * Int64::MaxValue);
// Categorize random numbers.
count[(int) (number / ONE_TENTH)]++;
}
// Display breakdown by range.
Console::WriteLine("{0,28} {1,32}   {2,7}\n", "Range", "Count", "Pct.");
for (int ctr = 0; ctr <= 9; ctr++)
Console::WriteLine("{0,25:N0}-{1,25:N0}  {2,8:N0}   {3,7:P2}", ctr * ONE_TENTH,
ctr < 9 ? ctr * ONE_TENTH + ONE_TENTH - 1 : Int64::MaxValue,
count[ctr], count[ctr]/20000000.0);
}
// The example displays output like the following:
//                           Range                            Count      Pct.
//
//                            0-  922,337,203,685,477,580  1,996,148    9.98 %
//      922,337,203,685,477,581-1,844,674,407,370,955,161  2,000,293   10.00 %
//    1,844,674,407,370,955,162-2,767,011,611,056,432,742  2,000,094   10.00 %
//    2,767,011,611,056,432,743-3,689,348,814,741,910,323  2,000,159   10.00 %
//    3,689,348,814,741,910,324-4,611,686,018,427,387,904  1,999,552   10.00 %
//    4,611,686,018,427,387,905-5,534,023,222,112,865,485  1,998,248    9.99 %
//    5,534,023,222,112,865,486-6,456,360,425,798,343,066  2,000,696   10.00 %
//    6,456,360,425,798,343,067-7,378,697,629,483,820,647  2,001,637   10.01 %
//    7,378,697,629,483,820,648-8,301,034,833,169,298,228  2,002,870   10.01 %
//    8,301,034,833,169,298,229-9,223,372,036,854,775,807  2,000,303   10.00 %
``````
``````const long ONE_TENTH = 922337203685477581;

Random rnd = new Random();
long number;
int[] count = new int[10];

// Generate 20 million long integers.
for (int ctr = 1; ctr <= 20000000; ctr++) {
number = (long) (rnd.NextDouble() * Int64.MaxValue);
// Categorize random numbers.
count[(int) (number / ONE_TENTH)]++;
}
// Display breakdown by range.
Console.WriteLine("{0,28} {1,32}   {2,7}\n", "Range", "Count", "Pct.");
for (int ctr = 0; ctr <= 9; ctr++)
Console.WriteLine("{0,25:N0}-{1,25:N0}  {2,8:N0}   {3,7:P2}", ctr * ONE_TENTH,
ctr < 9 ? ctr * ONE_TENTH + ONE_TENTH - 1 : Int64.MaxValue,
count[ctr], count[ctr]/20000000.0);

// The example displays output like the following:
//                           Range                            Count      Pct.
//
//                            0-  922,337,203,685,477,580  1,996,148    9.98 %
//      922,337,203,685,477,581-1,844,674,407,370,955,161  2,000,293   10.00 %
//    1,844,674,407,370,955,162-2,767,011,611,056,432,742  2,000,094   10.00 %
//    2,767,011,611,056,432,743-3,689,348,814,741,910,323  2,000,159   10.00 %
//    3,689,348,814,741,910,324-4,611,686,018,427,387,904  1,999,552   10.00 %
//    4,611,686,018,427,387,905-5,534,023,222,112,865,485  1,998,248    9.99 %
//    5,534,023,222,112,865,486-6,456,360,425,798,343,066  2,000,696   10.00 %
//    6,456,360,425,798,343,067-7,378,697,629,483,820,647  2,001,637   10.01 %
//    7,378,697,629,483,820,648-8,301,034,833,169,298,228  2,002,870   10.01 %
//    8,301,034,833,169,298,229-9,223,372,036,854,775,807  2,000,303   10.00 %
``````
``````Module Example
Public Sub Main()
Const ONE_TENTH As Long = 922337203685477581

Dim rnd As New Random()
Dim number As Long
Dim count(9) As Integer

' Generate 20 million long integers.
For ctr As Integer = 1 To 20000000
number = CLng(rnd.NextDouble() * Int64.MaxValue)
' Categorize random numbers.
count(CInt(number \ ONE_TENTH)) += 1
Next
' Display breakdown by range.
Console.WriteLine("{0,28} {1,32}   {2,7}", "Range", "Count", "Pct.")
Console.WriteLine()
For ctr As Integer = 0 To 9
Console.WriteLine("{0,25:N0}-{1,25:N0}  {2,8:N0}   {3,7:P2}", ctr * ONE_TENTH,
If(ctr < 9, ctr * ONE_TENTH + ONE_TENTH - 1, Int64.MaxValue),
count(ctr), count(ctr)/20000000)
Next
End Sub
End Module
' The example displays output like the following:
'                           Range                            Count      Pct.
'
'                            0-  922,337,203,685,477,580  1,996,148    9.98 %
'      922,337,203,685,477,581-1,844,674,407,370,955,161  2,000,293   10.00 %
'    1,844,674,407,370,955,162-2,767,011,611,056,432,742  2,000,094   10.00 %
'    2,767,011,611,056,432,743-3,689,348,814,741,910,323  2,000,159   10.00 %
'    3,689,348,814,741,910,324-4,611,686,018,427,387,904  1,999,552   10.00 %
'    4,611,686,018,427,387,905-5,534,023,222,112,865,485  1,998,248    9.99 %
'    5,534,023,222,112,865,486-6,456,360,425,798,343,066  2,000,696   10.00 %
'    6,456,360,425,798,343,067-7,378,697,629,483,820,647  2,001,637   10.01 %
'    7,378,697,629,483,820,648-8,301,034,833,169,298,228  2,002,870   10.01 %
'    8,301,034,833,169,298,229-9,223,372,036,854,775,807  2,000,303   10.00 %
``````

Eine alternative Methode, die Bitmanipulation verwendet, generiert keine wirklich zufälligen Zahlen.An alternative technique that uses bit manipulation does not generate truly random numbers. Mit dieser Technik werden Next() aufgerufen, um zwei Ganzzahlen zu generieren, um eine nach 32 Bits zu verschieben, und Sie werden miteinander verknüpft.This technique calls Next() to generate two integers, left-shifts one by 32 bits, and ORs them together. Diese Methode hat zwei Einschränkungen:This technique has two limitations:

1. Da Bit 31 das Signier Bit ist, ist der Wert in Bit 31 der resultierenden Long-Ganzzahl immer 0.Because bit 31 is the sign bit, the value in bit 31 of the resulting long integer is always 0. Dies kann behoben werden, indem ein zufälliger 0-oder 1-Bit-Wert generiert wird, bei dem der Wert für 31 Bits nach links verschoben und mit der ursprünglichen zufälligen Long-GanzzahlThis can be addressed by generating a random 0 or 1, left-shifting it 31 bits, and ORing it with the original random long integer.

2. Da die Wahrscheinlichkeit, dass der Wert, der von Next() zurückgegeben wird, 0 (null) ist, gibt es nur wenige, wenn eine Zufallszahl im Bereich von 0x0-0x00000000FFFFFFFF liegt.More seriously, because the probability that the value returned by Next() will be 0, there will be few if any random numbers in the range 0x0-0x00000000FFFFFFFF.

#### Abrufen von Bytes in einem angegebenen BereichRetrieve bytes in a specified range

Die über Ladungen der Next-Methode ermöglichen es Ihnen, den Bereich von Zufallszahlen anzugeben, die NextBytes-Methode jedoch nicht.The overloads of the Next method allow you to specify the range of random numbers, but the NextBytes method does not. Im folgenden Beispiel wird eine `NextBytes`-Methode implementiert, mit der Sie den Bereich der zurückgegebenen Bytes angeben können.The following example implements a `NextBytes` method that lets you specify the range of the returned bytes. Es definiert eine `Random2` Klasse, die von Random abgeleitet ist und die `NextBytes`-Methode überlädt.It defines a `Random2` class that derives from Random and overloads its `NextBytes` method.

``````using namespace System;

ref class Random2 : Random
{
public:
Random2()
{}

Random2(int seed) : Random(seed)
{}

void NextBytes(array<Byte>^ bytes, Byte minValue, Byte maxValue)
{
for (int ctr = bytes->GetLowerBound(0); ctr <= bytes->GetUpperBound(0); ctr++)
bytes[ctr] = (Byte) Next(minValue, maxValue);
}
};

void main()
{
Random2^ rnd = gcnew Random2();
array<Byte>^ bytes = gcnew array<Byte>(10000);
array<int>^ total = gcnew array<int>(101);
rnd->NextBytes(bytes, 0, 101);

// Calculate how many of each value we have.
for each (Byte value in bytes)
total[value]++;

// Display the results.
for (int ctr = 0; ctr < total->Length; ctr++) {
Console::Write("{0,3}: {1,-3}   ", ctr, total[ctr]);
if ((ctr + 1) % 5 == 0) Console::WriteLine();
}
}
// The example displays output like the following:
//         0: 115     1: 119     2: 92      3: 98      4: 92
//         5: 102     6: 103     7: 84      8: 93      9: 116
//        10: 91     11: 98     12: 106    13: 91     14: 92
//        15: 101    16: 100    17: 96     18: 97     19: 100
//        20: 101    21: 106    22: 112    23: 82     24: 85
//        25: 102    26: 107    27: 98     28: 106    29: 102
//        30: 109    31: 108    32: 94     33: 101    34: 107
//        35: 101    36: 86     37: 100    38: 101    39: 102
//        40: 113    41: 95     42: 96     43: 89     44: 99
//        45: 81     46: 89     47: 105    48: 100    49: 85
//        50: 103    51: 103    52: 93     53: 89     54: 91
//        55: 97     56: 105    57: 97     58: 110    59: 86
//        60: 116    61: 94     62: 117    63: 98     64: 110
//        65: 93     66: 102    67: 100    68: 105    69: 83
//        70: 81     71: 97     72: 85     73: 70     74: 98
//        75: 100    76: 110    77: 114    78: 83     79: 90
//        80: 96     81: 112    82: 102    83: 102    84: 99
//        85: 81     86: 100    87: 93     88: 99     89: 118
//        90: 95     91: 124    92: 108    93: 96     94: 104
//        95: 106    96: 99     97: 99     98: 92     99: 99
//       100: 108
``````
``````using System;

public class Example
{
public static void Main()
{
Random2 rnd = new Random2();
Byte[] bytes = new Byte[10000];
int[] total = new int[101];
rnd.NextBytes(bytes, 0, 101);

// Calculate how many of each value we have.
foreach (var value in bytes)
total[value]++;

// Display the results.
for (int ctr = 0; ctr < total.Length; ctr++) {
Console.Write("{0,3}: {1,-3}   ", ctr, total[ctr]);
if ((ctr + 1) % 5 == 0) Console.WriteLine();
}
}
}

public class Random2 : Random
{
public Random2() : base()
{}

public Random2(int seed) : base(seed)
{}

public void NextBytes(byte[] bytes, byte minValue, byte maxValue)
{
for (int ctr = bytes.GetLowerBound(0); ctr <= bytes.GetUpperBound(0); ctr++)
bytes[ctr] = (byte) Next(minValue, maxValue);
}
}
// The example displays output like the following:
//         0: 115     1: 119     2: 92      3: 98      4: 92
//         5: 102     6: 103     7: 84      8: 93      9: 116
//        10: 91     11: 98     12: 106    13: 91     14: 92
//        15: 101    16: 100    17: 96     18: 97     19: 100
//        20: 101    21: 106    22: 112    23: 82     24: 85
//        25: 102    26: 107    27: 98     28: 106    29: 102
//        30: 109    31: 108    32: 94     33: 101    34: 107
//        35: 101    36: 86     37: 100    38: 101    39: 102
//        40: 113    41: 95     42: 96     43: 89     44: 99
//        45: 81     46: 89     47: 105    48: 100    49: 85
//        50: 103    51: 103    52: 93     53: 89     54: 91
//        55: 97     56: 105    57: 97     58: 110    59: 86
//        60: 116    61: 94     62: 117    63: 98     64: 110
//        65: 93     66: 102    67: 100    68: 105    69: 83
//        70: 81     71: 97     72: 85     73: 70     74: 98
//        75: 100    76: 110    77: 114    78: 83     79: 90
//        80: 96     81: 112    82: 102    83: 102    84: 99
//        85: 81     86: 100    87: 93     88: 99     89: 118
//        90: 95     91: 124    92: 108    93: 96     94: 104
//        95: 106    96: 99     97: 99     98: 92     99: 99
//       100: 108
``````
``````Module Example
Public Sub Main()
Dim rnd As New Random2()
Dim bytes(9999) As Byte
Dim total(100) As Integer
rnd.NextBytes(bytes, 0, 101)

' Calculate how many of each value we have.
For Each value In bytes
total(value) += 1
Next

' Display the results.
For ctr As Integer = 0 To total.Length - 1
Console.Write("{0,3}: {1,-3}   ", ctr, total(ctr))
If (ctr + 1) Mod 5 = 0 Then Console.WriteLine()
Next
End Sub
End Module

Public Class Random2 : Inherits Random
Public Sub New()
MyBase.New()
End Sub

Public Sub New(seed As Integer)
MyBase.New(seed)
End Sub

Public Overloads Sub NextBytes(bytes() As Byte,
minValue As Byte, maxValue As Byte)
For ctr As Integer = bytes.GetLowerbound(0) To bytes.GetUpperBound(0)
bytes(ctr) = CByte(MyBase.Next(minValue, maxValue))
Next
End Sub
End Class
' The example displays output like the following:
'         0: 115     1: 119     2: 92      3: 98      4: 92
'         5: 102     6: 103     7: 84      8: 93      9: 116
'        10: 91     11: 98     12: 106    13: 91     14: 92
'        15: 101    16: 100    17: 96     18: 97     19: 100
'        20: 101    21: 106    22: 112    23: 82     24: 85
'        25: 102    26: 107    27: 98     28: 106    29: 102
'        30: 109    31: 108    32: 94     33: 101    34: 107
'        35: 101    36: 86     37: 100    38: 101    39: 102
'        40: 113    41: 95     42: 96     43: 89     44: 99
'        45: 81     46: 89     47: 105    48: 100    49: 85
'        50: 103    51: 103    52: 93     53: 89     54: 91
'        55: 97     56: 105    57: 97     58: 110    59: 86
'        60: 116    61: 94     62: 117    63: 98     64: 110
'        65: 93     66: 102    67: 100    68: 105    69: 83
'        70: 81     71: 97     72: 85     73: 70     74: 98
'        75: 100    76: 110    77: 114    78: 83     79: 90
'        80: 96     81: 112    82: 102    83: 102    84: 99
'        85: 81     86: 100    87: 93     88: 99     89: 118
'        90: 95     91: 124    92: 108    93: 96     94: 104
'        95: 106    96: 99     97: 99     98: 92     99: 99
'       100: 108
``````

Die `NextBytes(Byte[], Byte, Byte)`-Methode umschließt einen aufzurufenden Next(Int32, Int32) Methode und gibt den Minimalwert und einen größer als den maximalen Wert (in diesem Fall 0 und 101) an, der im Bytearray zurückgegeben werden soll.The `NextBytes(Byte[], Byte, Byte)` method wraps a call to the Next(Int32, Int32) method and specifies the minimum value and one greater than the maximum value (in this case, 0 and 101) that we want returned in the byte array. Da wir sicher sind, dass die von der Next-Methode zurückgegebenen ganzzahligen Werte innerhalb des Bereichs des Byte Datentyps liegen, können C#wir Sie problemlos umwandeln (in) oder von ganzen Zahlen in Bytes konvertieren (in Visual Basic).Because we are sure that the integer values returned by the Next method are within the range of the Byte data type, we can safely cast them (in C#) or convert them (in Visual Basic) from integers to bytes.

#### Abrufen eines Elements aus einem Array oder einer Auflistung nach dem ZufallsprinzipRetrieve an element from an array or collection at random

Zufallszahlen dienen häufig als Indizes zum Abrufen von Werten aus Arrays oder Auflistungen.Random numbers often serve as indexes to retrieve values from arrays or collections. Wenn Sie einen zufälligen Indexwert abrufen möchten, können Sie die Next(Int32, Int32)-Methode aufrufen und die untere Grenze des Arrays als Wert seines `minValue` Arguments und einen größer als die obere Grenze des Arrays als Wert seines `maxValue` Arguments verwenden.To retrieve a random index value, you can call the Next(Int32, Int32) method, and use the lower bound of the array as the value of its `minValue` argument and one greater than the upper bound of the array as the value of its `maxValue` argument. Für ein NULL basiertes Array entspricht dies der Length-Eigenschaft, oder eine größer als der Wert, der von der Array.GetUpperBound-Methode zurückgegeben wird.For a zero-based array, this is equivalent to its Length property, or one greater than the value returned by the Array.GetUpperBound method. Im folgenden Beispiel wird der Name einer Stadt im USA aus einem Array von Städten nach dem Zufallsprinzip abgerufen.The following example randomly retrieves the name of a city in the United States from an array of cities.

``````using namespace System;

void main()
{
array<String^>^ cities = { "Atlanta", "Boston", "Chicago", "Detroit",
"Fort Wayne", "Greensboro", "Honolulu", "Indianapolis",
"Jersey City", "Kansas City", "Los Angeles",
"Raleigh", "San Francisco", "Tulsa", "Washington" };
Random^ rnd = gcnew Random();
int index = rnd->Next(0, cities->Length);
Console::WriteLine("Today's city of the day: {0}",
cities[index]);
}
// The example displays output like the following:
//   Today's city of the day: Honolulu
``````
``````String[] cities = { "Atlanta", "Boston", "Chicago", "Detroit",
"Fort Wayne", "Greensboro", "Honolulu", "Indianapolis",
"Jersey City", "Kansas City", "Los Angeles",
"Raleigh", "San Francisco", "Tulsa", "Washington" };
Random rnd = new Random();
int index = rnd.Next(0, cities.Length);
Console.WriteLine("Today's city of the day: {0}",
cities[index]);

// The example displays output like the following:
//   Today's city of the day: Honolulu
``````
``````Module Example
Public Sub Main()
Dim cities() As String = { "Atlanta", "Boston", "Chicago", "Detroit",
"Fort Wayne", "Greensboro", "Honolulu", "Indianapolis",
"Jersey City", "Kansas City", "Los Angeles",
"Raleigh", "San Francisco", "Tulsa", "Washington" }
Dim rnd As New Random()
Dim index As Integer = rnd.Next(0, cities.Length)
Console.WriteLine("Today's city of the day: {0}",
cities(index))
End Sub
End Module
' The example displays output like the following:
'   Today's city of the day: Honolulu
``````

#### Abrufen eines eindeutigen Elements aus einem Array oder einer AuflistungRetrieve a unique element from an array or collection

Ein Zufallszahlengenerator kann immer doppelte Werte zurückgeben.A random number generator can always return duplicate values. Wenn der Bereich der Zahlen kleiner wird oder die Anzahl der generierten Werte größer ist, wächst die Wahrscheinlichkeit von Duplikaten.As the range of numbers becomes smaller or the number of values generated becomes larger, the probability of duplicates grows. Wenn zufällige Werte eindeutig sein müssen, werden mehr Zahlen generiert, um Duplikate zu kompensieren. Dies führt zu einer zunehmend schlechten Leistung.If random values must be unique, more numbers are generated to compensate for duplicates, resulting in increasingly poor performance.

Es gibt eine Reihe von Techniken zum Behandeln dieses Szenarios.There are a number of techniques to handle this scenario. Eine gängige Lösung besteht darin, ein Array oder eine Sammlung zu erstellen, das die abzurufenden Werte enthält, sowie ein paralleles Array, das zufällige Gleit Komma Zahlen enthält.One common solution is to create an array or collection that contains the values to be retrieved, and a parallel array that contains random floating-point numbers. Das zweite Array wird mit Zufallszahlen aufgefüllt, wenn das erste Array erstellt wird, und die Array.Sort(Array, Array)-Methode wird verwendet, um das erste Array mithilfe der Werte im parallelen Array zu sortieren.The second array is populated with random numbers at the time the first array is created, and the Array.Sort(Array, Array) method is used to sort the first array by using the values in the parallel array.

Wenn Sie z. b. ein Solitaire-Spiel entwickeln, sollten Sie sicherstellen, dass jede Karte nur einmal verwendet wird.For example, if you're developing a Solitaire game, you want to ensure that each card is used only once. Anstatt Zufallszahlen zum Abrufen einer Karte und nachverfolgen, ob diese Karte bereits behandelt wurde, zu erzeugen, können Sie ein paralleles Array von Zufallszahlen erstellen, das zum Sortieren des Stapels verwendet werden kann.Instead of generating random numbers to retrieve a card and tracking whether that card has already been dealt, you can create a parallel array of random numbers that can be used to sort the deck. Sobald der Stapel sortiert ist, kann Ihre APP einen Zeiger behalten, um den Index der nächsten Karte auf dem Stapel anzugeben.Once the deck is sorted, your app can maintain a pointer to indicate the index of the next card on the deck.

Dieser Ansatz wird anhand des folgenden Beispiels veranschaulicht.The following example illustrates this approach. Es definiert eine `Card` Klasse, die eine Wiedergabe Karte und eine `Dealer` Klasse darstellt, die einen Stapel von gemischten Karten behandelt.It defines a `Card` class that represents a playing card and a `Dealer` class that deals a deck of shuffled cards. Der `Dealer`-Klassenkonstruktor füllt zwei Arrays auf: ein `deck` Array mit Klassen Bereich, das alle Karten im Stapel darstellt. und ein lokales `order` Array, das über die gleiche Anzahl von Elementen wie das `deck` Array verfügt und mit zufällig generierten Double Werten aufgefüllt wird.The `Dealer` class constructor populates two arrays: a `deck` array that has class scope and that represents all the cards in the deck; and a local `order` array that has the same number of elements as the `deck` array and is populated with randomly generated Double values. Die Array.Sort(Array, Array)-Methode wird dann aufgerufen, um das `deck` Array basierend auf den Werten im `order` Array zu sortieren.The Array.Sort(Array, Array) method is then called to sort the `deck` array based on the values in the `order` array.

``````using namespace System;

public enum class Suit { Hearts, Diamonds, Spades, Clubs };

public enum class FaceValue  { Ace = 1, Two, Three, Four, Five, Six,
Seven, Eight, Nine, Ten, Jack, Queen,
King };

// A class that represents an individual card in a playing deck.
ref class Card
{
public:
Suit Suit;
FaceValue FaceValue;

String^ ToString() override
{
return String::Format("{0:F} of {1:F}", this->FaceValue, this->Suit);
}
};

ref class Dealer
{
private:
Random^ rnd;
// A deck of cards, without Jokers.
array<Card^>^ deck = gcnew array<Card^>(52);
// Parallel array for sorting cards.
array<Double>^ order = gcnew array<Double>(52);
// A pointer to the next card to deal.
int ptr = 0;
// A flag to indicate the deck is used.
bool mustReshuffle = false;

public:
Dealer()
{
rnd = gcnew Random();
// Initialize the deck.
int deckCtr = 0;
for each (auto suit in Enum::GetValues(Suit::typeid)) {
for each (FaceValue faceValue in Enum::GetValues(FaceValue::typeid)) {
Card^ card = gcnew Card();
card->Suit = (Suit) suit;
card->FaceValue = (FaceValue) faceValue;
deck[deckCtr] = card;
deckCtr++;
}
}

for (int ctr = 0; ctr < order->Length; ctr++)
order[ctr] = rnd->NextDouble();

Array::Sort(order, deck);
}

array<Card^>^ Deal(int numberToDeal)
{
if (mustReshuffle) {
Console::WriteLine("There are no cards left in the deck");
return nullptr;
}

array<Card^>^ cardsDealt = gcnew array<Card^>(numberToDeal);
for (int ctr = 0; ctr < numberToDeal; ctr++) {
cardsDealt[ctr] = deck[ptr];
ptr++;
if (ptr == deck->Length)
mustReshuffle = true;

if (mustReshuffle & ctr < numberToDeal - 1) {
Console::WriteLine("Can only deal the {0} cards remaining on the deck.",
ctr + 1);
return cardsDealt;
}
}
return cardsDealt;
}
};

void ShowCards(array<Card^>^ cards)
{
for each (Card^ card in cards)
if (card != nullptr)
Console::WriteLine("{0} of {1}", card->FaceValue, card->Suit);
};

void main()
{
Dealer^ dealer = gcnew Dealer();
ShowCards(dealer->Deal(20));
}

// The example displays output like the following:
//       Six of Diamonds
//       King of Clubs
//       Eight of Clubs
//       Seven of Clubs
//       Queen of Clubs
//       King of Hearts
//       Ace of Clubs
//       Four of Hearts
//       Three of Diamonds
//       Nine of Diamonds
//       Two of Hearts
//       Ace of Hearts
//       Three of Hearts
//       Eight of Hearts
//       Queen of Diamonds
//       Two of Clubs
//       Four of Diamonds
//       Jack of Hearts
``````
``````using System;

// A class that represents an individual card in a playing deck.
public class Card
{
public Suit Suit;
public FaceValue FaceValue;

public override String ToString()
{
return String.Format("{0:F} of {1:F}", this.FaceValue, this.Suit);
}
}

public enum Suit { Hearts, Diamonds, Spades, Clubs };

public enum FaceValue  { Ace = 1, Two, Three, Four, Five, Six,
Seven, Eight, Nine, Ten, Jack, Queen,
King };

public class Dealer
{
Random rnd;
// A deck of cards, without Jokers.
Card[] deck = new Card[52];
// Parallel array for sorting cards.
Double[] order = new Double[52];
// A pointer to the next card to deal.
int ptr = 0;
// A flag to indicate the deck is used.
bool mustReshuffle = false;

public Dealer()
{
rnd = new Random();
// Initialize the deck.
int deckCtr = 0;
foreach (var suit in Enum.GetValues(typeof(Suit))) {
foreach (var faceValue in Enum.GetValues(typeof(FaceValue))) {
Card card = new Card();
card.Suit = (Suit) suit;
card.FaceValue = (FaceValue) faceValue;
deck[deckCtr] = card;
deckCtr++;
}
}

for (int ctr = 0; ctr < order.Length; ctr++)
order[ctr] = rnd.NextDouble();

Array.Sort(order, deck);
}

public Card[] Deal(int numberToDeal)
{
if (mustReshuffle) {
Console.WriteLine("There are no cards left in the deck");
return null;
}

Card[] cardsDealt = new Card[numberToDeal];
for (int ctr = 0; ctr < numberToDeal; ctr++) {
cardsDealt[ctr] = deck[ptr];
ptr++;
if (ptr == deck.Length)
mustReshuffle = true;

if (mustReshuffle & ctr < numberToDeal - 1) {
Console.WriteLine("Can only deal the {0} cards remaining on the deck.",
ctr + 1);
return cardsDealt;
}
}
return cardsDealt;
}
}

public class Example
{
public static void Main()
{
Dealer dealer = new Dealer();
ShowCards(dealer.Deal(20));
}

private static void ShowCards(Card[] cards)
{
foreach (var card in cards)
if (card != null)
Console.WriteLine("{0} of {1}", card.FaceValue, card.Suit);
}
}
// The example displays output like the following:
//       Six of Diamonds
//       King of Clubs
//       Eight of Clubs
//       Seven of Clubs
//       Queen of Clubs
//       King of Hearts
//       Ace of Clubs
//       Four of Hearts
//       Three of Diamonds
//       Nine of Diamonds
//       Two of Hearts
//       Ace of Hearts
//       Three of Hearts
//       Eight of Hearts
//       Queen of Diamonds
//       Two of Clubs
//       Four of Diamonds
//       Jack of Hearts
``````
``````' A class that represents an individual card in a playing deck.
Public Class Card
Public Suit As Suit
Public FaceValue As FaceValue

Public Overrides Function ToString() As String
Return String.Format("{0:F} of {1:F}", Me.FaceValue, Me.Suit)
End Function
End Class

Public Enum Suit As Integer
Hearts = 0
Diamonds = 1
Clubs = 3
End Enum

Public Enum FaceValue As Integer
Ace = 1
Two = 2
Three = 3
Four = 4
Five = 5
Six = 6
Seven = 7
Eight = 8
Nine = 9
Ten = 10
Jack = 11
Queen = 12
King = 13
End Enum

Public Class Dealer
Dim rnd As Random
' A deck of cards, without Jokers.
Dim deck(51) As Card
' Parallel array for sorting cards.
Dim order(51) As Double
' A pointer to the next card to deal.
Dim ptr As Integer = 0
' A flag to indicate the deck is used.
Dim mustReshuffle As Boolean

Public Sub New()
rnd = New Random()
' Initialize the deck.
Dim deckCtr As Integer = 0
For Each Suit In [Enum].GetValues(GetType(Suit))
For Each faceValue In [Enum].GetValues(GetType(FaceValue))
Dim card As New Card()
card.Suit = CType(Suit, Suit)
card.FaceValue = CType(faceValue, FaceValue)
deck(deckCtr) = card
deckCtr += 1
Next
Next
For ctr As Integer = 0 To order.Length - 1
order(ctr) = rnd.NextDouble()
Next
Array.Sort(order, deck)
End Sub

Public Function Deal(numberToDeal As Integer) As Card()
If mustReshuffle Then
Console.WriteLine("There are no cards left in the deck")
Return Nothing
End If

Dim cardsDealt(numberToDeal - 1) As Card
For ctr As Integer = 0 To numberToDeal - 1
cardsDealt(ctr) = deck(ptr)
ptr += 1
If ptr = deck.Length Then
mustReshuffle = True
End If
If mustReshuffle And ctr < numberToDeal - 1
Console.WriteLine("Can only deal the {0} cards remaining on the deck.",
ctr + 1)
Return cardsDealt
End If
Next
Return cardsDealt
End Function
End Class

Public Module Example
Public Sub Main()
Dim dealer As New Dealer()
ShowCards(dealer.Deal(20))
End Sub

Private Sub ShowCards(cards() As Card)
For Each card In cards
If card IsNot Nothing Then _
Console.WriteLine("{0} of {1}", card.FaceValue, card.Suit)
Next
End Sub
End Module
' The example displays output like the following:
'       Six of Diamonds
'       King of Clubs
'       Eight of Clubs
'       Seven of Clubs
'       Queen of Clubs
'       King of Hearts
'       Ace of Clubs
'       Four of Hearts
'       Three of Diamonds
'       Nine of Diamonds
'       Two of Hearts
'       Ace of Hearts
'       Three of Hearts
'       Eight of Hearts
'       Queen of Diamonds
'       Two of Clubs
'       Four of Diamonds
'       Jack of Hearts
``````

## Hinweise für Vererber

In den .NET Framework 1,0 und 1,1 ist eine minimale Implementierung einer von Random abgeleiteten Klasse erforderlich, die die Sample()-Methode überschreibt, um einen neuen oder geänderten Algorithmus zum Erstellen von Zufallszahlen zu definieren.In the .NET Framework 1.0 and 1.1, a minimum implementation of a class derived from Random required overriding the Sample() method to define a new or modified algorithm for generating random numbers. Die abgeleitete Klasse kann dann auf die Basisklassen Implementierung der Methoden Next(), Next(Int32), Next(Int32, Int32), NextBytes(Byte[])und NextDouble() zurückgreifen, um die Implementierung der abgeleiteten Klasse der Sample()-Methode aufzurufen.The derived class could then rely on the base class implementation of the Next(), Next(Int32), Next(Int32, Int32), NextBytes(Byte[]), and NextDouble() methods to call the derived class implementation of the Sample() method.

In der .NET Framework 2,0 und höher wurde das Verhalten der Methoden Next(), Next(Int32, Int32)und NextBytes(Byte[]) geändert, sodass diese Methoden nicht notwendigerweise die Implementierung der abgeleiteten Klasse der Sample()-Methode aufzurufen.In the .NET Framework 2.0 and later, the behavior of the Next(), Next(Int32, Int32), and NextBytes(Byte[]) methods have changed so that these methods do not necessarily call the derived class implementation of the Sample() method. Daher sollten von Random abgeleitete Klassen, die auf .NET Framework 2,0 und höher ausgerichtet sind, auch diese drei Methoden überschrieben werden.As a result, classes derived from Random that target the .NET Framework 2.0 and later should also override these three methods.

## Hinweise für Aufrufer

Es ist nicht garantiert, dass die Implementierung des Zufallszahlengenerators in der Random-Klasse in den Hauptversionen des .NET Framework identisch bleibt.The implementation of the random number generator in the Random class isn't guaranteed to remain the same across major versions of the .NET Framework. Daher sollten Sie nicht davon ausgehen, dass derselbe Ausgangswert in verschiedenen Versionen der .NET Framework dieselbe pseudo zufällige Sequenz ergibt.As a result, you shouldn't assume that the same seed will result in the same pseudo-random sequence in different versions of the .NET Framework.

## Konstruktoren

 Initialisiert eine neue Instanz der Random-Klasse unter Verwendung eines zeitabhängigen Standardstartwerts.Initializes a new instance of the Random class, using a time-dependent default seed value. Initialisiert eine neue Instanz der Random-Klasse unter Verwendung des angegebenen Startwerts.Initializes a new instance of the Random class, using the specified seed value.

## Methoden

 Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object. (Geerbt von Object) Dient als die Standard-HashfunktionServes as the default hash function. (Geerbt von Object) Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance. (Geerbt von Object) Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object. (Geerbt von Object) Gibt eine nicht negative Zufallsganzzahl zurück.Returns a non-negative random integer. Gibt eine nicht negative Zufallsganzzahl zurück, die kleiner als das angegebene Maximum ist.Returns a non-negative random integer that is less than the specified maximum. Gibt eine Zufallsganzzahl zurück, die in einem angegebenen Bereich liegt.Returns a random integer that is within a specified range. Füllt die Elemente eines angegebenen Bytearrays mit Zufallszahlen.Fills the elements of a specified array of bytes with random numbers. Füllt die Elemente einer festgelegten Bytespanne mit zufälligen Zahlen.Fills the elements of a specified span of bytes with random numbers. Gibt eine zufällige Gleitkommazahl zurück, die größer oder gleich 0,0 und kleiner als 1,0 ist.Returns a random floating-point number that is greater than or equal to 0.0, and less than 1.0. Gibt eine zufällige Gleitkommazahl zwischen 0,0 und 1,0 zurück.Returns a random floating-point number between 0.0 and 1.0. Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object. (Geerbt von Object)