RandomNumberGenerator.GetBytes Methode

Definition

Namespace:

System.Security.Cryptography

Assemblys:

netstandard.dll, System.Security.Cryptography.dll

Füllt ein Bytearray mit einer kryptografisch starken zufälligen Abfolge von Werten.

Überlädt

Name	Beschreibung
GetBytes(Span<Byte>)	Füllt eine Spanne mit kryptografisch starken zufälligen Bytes.
GetBytes(Byte[], Int32, Int32)	Füllt das angegebene Bytearray mit einer kryptografisch starken zufallsstarken Folge von Werten.
GetBytes(Byte[])	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Bytearray mit einer kryptografisch starken zufallsstarken Abfolge von Werten gefüllt.
GetBytes(Int32)	Erstellt ein Bytearray mit einer kryptografisch starken zufälligen Abfolge von Werten.

GetBytes(Span<Byte>)

Quelle:

RandomNumberGenerator.cs

Füllt eine Spanne mit kryptografisch starken zufälligen Bytes.

public:
 virtual void GetBytes(Span<System::Byte> data);

public virtual void GetBytes(Span<byte> data);

abstract member GetBytes : Span<byte> -> unit
override this.GetBytes : Span<byte> -> unit

Public Overridable Sub GetBytes (data As Span(Of Byte))

Parameter

data

Span<Byte>

Die Spanne, die mit kryptografisch starken zufälligen Bytes gefüllt werden soll.

Weitere Informationen

• Fill(Span<Byte>)

GetBytes(Byte[], Int32, Int32)

Quelle:

RandomNumberGenerator.cs

Füllt das angegebene Bytearray mit einer kryptografisch starken zufallsstarken Folge von Werten.

public:
 virtual void GetBytes(cli::array <System::Byte> ^ data, int offset, int count);

public virtual void GetBytes(byte[] data, int offset, int count);

abstract member GetBytes : byte[] * int * int -> unit
override this.GetBytes : byte[] * int * int -> unit

Public Overridable Sub GetBytes (data As Byte(), offset As Integer, count As Integer)

Parameter

data

Byte[]

Das Array, das mit kryptografisch starken zufälligen Bytes gefüllt werden soll.

offset

Int32

Der Index des Arrays, um den Füllvorgang zu starten.

count

Int32

Die Anzahl der zu füllenden Bytes.

Ausnahmen

ArgumentNullException

data ist null.

ArgumentOutOfRangeException

offset oder count ist kleiner als 0

ArgumentException

offset plus count überschreitet die Länge von data.

GetBytes(Byte[])

Quelle:

RandomNumberGenerator.cs

Wenn eine abgeleitete Klasse überschrieben wird, wird ein Bytearray mit einer kryptografisch starken zufallsstarken Abfolge von Werten gefüllt.

public:
 abstract void GetBytes(cli::array <System::Byte> ^ data);

public abstract void GetBytes(byte[] data);

abstract member GetBytes : byte[] -> unit

Public MustOverride Sub GetBytes (data As Byte())

Parameter

data

Byte[]

Das Array, das mit kryptografisch starken zufälligen Bytes gefüllt werden soll.

Beispiele

Im folgenden Beispiel wird eine zufällige Sequenz von 100 Byte erstellt und gespeichert random.

byte[] random = new byte[100];

using (RandomNumberGenerator rng = RandomNumberGenerator.Create())
{
    rng.GetBytes(random); // The array is now filled with cryptographically strong random bytes.
}

Dim random() As Byte = New Byte(100) {}
       
Using rng As RandomNumberGenerator = RandomNumberGenerator.Create()
   rng.GetBytes(random) ' bytes in random are now random
End Using

Hinweise

Die Länge des Bytearrays bestimmt, wie viele zufällige Bytes erzeugt werden.

Weitere Informationen

• Fill(Span<Byte>)
• Kryptografiedienste

GetBytes(Int32)

Quelle:

RandomNumberGenerator.cs

Erstellt ein Bytearray mit einer kryptografisch starken zufälligen Abfolge von Werten.

public:
 static cli::array <System::Byte> ^ GetBytes(int count);

public static byte[] GetBytes(int count);

static member GetBytes : int -> byte[]

Public Shared Function GetBytes (count As Integer) As Byte()

Parameter

count

Int32

Die Anzahl der zu erstellenden Byte von Zufallswerten.

Gibt zurück

Byte[]

Ein Array mit kryptografisch starken Zufallswerten aufgefüllt.

Ausnahmen

ArgumentOutOfRangeException

count ist kleiner als 0 (null).