RandomNumberGenerator.GetBytes Método

Definição

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

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

Sobrecargas

Nome Description
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.
GetBytes(Int32)

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

GetBytes(Span<Byte>)

Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs

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)

Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs

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

GetBytes(Byte[])

Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs

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

Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs
Origem:
RandomNumberGenerator.cs

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

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

Parâmetros

count
Int32

O número de bytes de valores aleatórios a serem criados.

Retornos

Byte[]

Uma matriz populada com valores aleatórios criptograficamente fortes.

Exceções

ArgumentOutOfRangeException

count é menor que zero.

Aplica-se a