RNGCryptoServiceProvider Construtores

Definição

Inicializa uma nova instância da classe RNGCryptoServiceProvider.

Sobrecargas

RNGCryptoServiceProvider()

Inicializa uma nova instância da classe RNGCryptoServiceProvider.

RNGCryptoServiceProvider(Byte[])

Inicializa uma nova instância da classe RNGCryptoServiceProvider.

RNGCryptoServiceProvider(CspParameters)

Inicializa uma nova instância da classe RNGCryptoServiceProvider com os parâmetros especificados.

RNGCryptoServiceProvider(String)

Inicializa uma nova instância da classe RNGCryptoServiceProvider.

RNGCryptoServiceProvider()

Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs

Inicializa uma nova instância da classe RNGCryptoServiceProvider.

public RNGCryptoServiceProvider ();

Exemplos

O exemplo de código a seguir mostra como criar um número aleatório com a RNGCryptoServiceProvider classe .

//The following sample uses the Cryptography class to simulate the roll of a dice.

using System;
using System.IO;
using System.Text;
using System.Security.Cryptography;

class RNGCSP
{
    private static RNGCryptoServiceProvider rngCsp = new RNGCryptoServiceProvider();
    // Main method.
    public static void Main()
    {
        const int totalRolls = 25000;
        int[] results = new int[6];

        // Roll the dice 25000 times and display
        // the results to the console.
        for (int x = 0; x < totalRolls; x++)
        {
            byte roll = RollDice((byte)results.Length);
            results[roll - 1]++;
        }
        for (int i = 0; i < results.Length; ++i)
        {
            Console.WriteLine("{0}: {1} ({2:p1})", i + 1, results[i], (double)results[i] / (double)totalRolls);
        }
        rngCsp.Dispose();
    }

    // This method simulates a roll of the dice. The input parameter is the
    // number of sides of the dice.

    public static byte RollDice(byte numberSides)
    {
        if (numberSides <= 0)
            throw new ArgumentOutOfRangeException("numberSides");

        // Create a byte array to hold the random value.
        byte[] randomNumber = new byte[1];
        do
        {
            // Fill the array with a random value.
            rngCsp.GetBytes(randomNumber);
        }
        while (!IsFairRoll(randomNumber[0], numberSides));
        // Return the random number mod the number
        // of sides.  The possible values are zero-
        // based, so we add one.
        return (byte)((randomNumber[0] % numberSides) + 1);
    }

    private static bool IsFairRoll(byte roll, byte numSides)
    {
        // There are MaxValue / numSides full sets of numbers that can come up
        // in a single byte.  For instance, if we have a 6 sided die, there are
        // 42 full sets of 1-6 that come up.  The 43rd set is incomplete.
        int fullSetsOfValues = Byte.MaxValue / numSides;

        // If the roll is within this range of fair values, then we let it continue.
        // In the 6 sided die case, a roll between 0 and 251 is allowed.  (We use
        // < rather than <= since the = portion allows through an extra 0 value).
        // 252 through 255 would provide an extra 0, 1, 2, 3 so they are not fair
        // to use.
        return roll < numSides * fullSetsOfValues;
    }
}

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

RNGCryptoServiceProvider(Byte[])

Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs

Inicializa uma nova instância da classe RNGCryptoServiceProvider.

public RNGCryptoServiceProvider (byte[] rgb);

Parâmetros

rgb
Byte[]

Uma matriz de bytes. Este valor é ignorado.

Comentários

Esse método não inicializa diretamente a RNGCryptoServiceProvider classe . Chamar esse método é equivalente a chamar o RNGCryptoServiceProvider(CspParameters) construtor e passar null.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

RNGCryptoServiceProvider(CspParameters)

Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs

Inicializa uma nova instância da classe RNGCryptoServiceProvider com os parâmetros especificados.

public RNGCryptoServiceProvider (System.Security.Cryptography.CspParameters? cspParams);
public RNGCryptoServiceProvider (System.Security.Cryptography.CspParameters cspParams);

Parâmetros

cspParams
CspParameters

Os parâmetros a serem passados para o CSP (provedor de serviços de criptografia).

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

RNGCryptoServiceProvider(String)

Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs
Origem:
RNGCryptoServiceProvider.cs

Inicializa uma nova instância da classe RNGCryptoServiceProvider.

public RNGCryptoServiceProvider (string str);

Parâmetros

str
String

A entrada da cadeia de caracteres. Este parâmetro é ignorado.

Comentários

Esse método não inicializa diretamente a RNGCryptoServiceProvider classe . Chamar esse método é equivalente a chamar o RNGCryptoServiceProvider(CspParameters) construtor e passar null.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1