RandomNumberGenerator.GetBytes Método

Definição

Namespace:
System.Security.Cryptography
Assembly:
mscorlib.dll
Assembly:
System.Security.Cryptography.Algorithms.dll
Assembly:
netstandard.dll

Preenche uma matriz de bytes com uma sequência aleatória de valores criptograficamente forte.

Sobrecargas

Nome Description
GetBytes(Byte[])

Quando substituído em uma classe derivada, preenche uma matriz de bytes com uma sequência aleatória de valores criptograficamente forte.
GetBytes(Span<Byte>)

Preenche um intervalo com bytes aleatórios criptograficamente fortes.
GetBytes(Byte[], Int32, Int32)

Preenche a matriz de bytes especificada com uma sequência aleatória de valores criptograficamente forte.

GetBytes(Byte[])

Quando substituído em uma classe derivada, preenche uma matriz de bytes com uma sequência aleatória de valores criptograficamente forte.

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())

Parâmetros

data
Byte[]

A matriz a ser preenchida com bytes aleatórios criptograficamente fortes.

Exemplos

O exemplo a seguir cria uma sequência aleatória de 100 bytes de comprimento e a armazena em 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

Comentários

O comprimento da matriz de bytes determina quantos bytes aleatórios são produzidos.

Confira também

Aplica-se a

GetBytes(Span<Byte>)

Preenche um intervalo com bytes aleatórios criptograficamente fortes.

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

Parâmetros

data
Span<Byte>

O intervalo a ser preenchido com bytes aleatórios criptograficamente fortes.

Confira também

Aplica-se a

GetBytes(Byte[], Int32, Int32)

Preenche a matriz de bytes especificada com uma sequência aleatória de valores criptograficamente forte.

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)

Parâmetros

data
Byte[]

A matriz a ser preenchida com bytes aleatórios criptograficamente fortes.

offset
Int32

O índice da matriz para iniciar a operação de preenchimento.

count
Int32

O número de bytes a serem preenchidos.

Exceções

ArgumentNullException

data é null.

ArgumentOutOfRangeException

offset ou count é menor que 0

ArgumentException

offset plus count excede o comprimento de data.

Aplica-se a