RNGCryptoServiceProvider コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。
オーバーロード
| 名前 | 説明 |
|---|---|
| RNGCryptoServiceProvider() |
RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。 |
| RNGCryptoServiceProvider(Byte[]) |
RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。 |
| RNGCryptoServiceProvider(CspParameters) |
指定したパラメーターを使用して、 RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。 |
| RNGCryptoServiceProvider(String) |
RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。 |
RNGCryptoServiceProvider()
RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。
public:
RNGCryptoServiceProvider();
public RNGCryptoServiceProvider();
Public Sub New ()
例
次のコード例は、 RNGCryptoServiceProvider クラスを使用して乱数を作成する方法を示しています。
//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;
}
}
'The following sample uses the Cryptography class to simulate the roll of a dice.
Imports System.IO
Imports System.Text
Imports System.Security.Cryptography
Class RNGCSP
Private Shared rngCsp As New RNGCryptoServiceProvider()
' Main method.
Public Shared Sub Main()
Const totalRolls As Integer = 25000
Dim results(5) As Integer
' Roll the dice 25000 times and display
' the results to the console.
Dim x As Integer
For x = 0 To totalRolls
Dim roll As Byte = RollDice(System.Convert.ToByte(results.Length))
results((roll - 1)) += 1
Next x
Dim i As Integer
While i < results.Length
Console.WriteLine("{0}: {1} ({2:p1})", i + 1, results(i), System.Convert.ToDouble(results(i)) / System.Convert.ToDouble(totalRolls))
i += 1
End While
rngCsp.Dispose()
End Sub
' This method simulates a roll of the dice. The input parameter is the
' number of sides of the dice.
Public Shared Function RollDice(ByVal numberSides As Byte) As Byte
If numberSides <= 0 Then
Throw New ArgumentOutOfRangeException("NumSides")
End If
' Create a byte array to hold the random value.
Dim randomNumber(0) As Byte
Do
' Fill the array with a random value.
rngCsp.GetBytes(randomNumber)
Loop While Not IsFairRoll(randomNumber(0), numberSides)
' Return the random number mod the number
' of sides. The possible values are zero-
' based, so we add one.
Return System.Convert.ToByte(randomNumber(0) Mod numberSides + 1)
End Function
Private Shared Function IsFairRoll(ByVal roll As Byte, ByVal numSides As Byte) As Boolean
' 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.
Dim fullSetsOfValues As Integer = [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
End Function 'IsFairRoll
End Class
こちらもご覧ください
適用対象
RNGCryptoServiceProvider(Byte[])
RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。
public:
RNGCryptoServiceProvider(cli::array <System::Byte> ^ rgb);
public RNGCryptoServiceProvider(byte[] rgb);
new System.Security.Cryptography.RNGCryptoServiceProvider : byte[] -> System.Security.Cryptography.RNGCryptoServiceProvider
Public Sub New (rgb As Byte())
パラメーター
- rgb
- Byte[]
バイト配列。 この値は無視されます。
注釈
このメソッドは、 RNGCryptoServiceProvider クラスを直接初期化しません。 このメソッドの呼び出しは、 RNGCryptoServiceProvider(CspParameters) コンストラクターを呼び出し、 nullを渡すことと同じです。
こちらもご覧ください
適用対象
RNGCryptoServiceProvider(CspParameters)
指定したパラメーターを使用して、 RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。
public:
RNGCryptoServiceProvider(System::Security::Cryptography::CspParameters ^ cspParams);
public RNGCryptoServiceProvider(System.Security.Cryptography.CspParameters? cspParams);
public RNGCryptoServiceProvider(System.Security.Cryptography.CspParameters cspParams);
new System.Security.Cryptography.RNGCryptoServiceProvider : System.Security.Cryptography.CspParameters -> System.Security.Cryptography.RNGCryptoServiceProvider
Public Sub New (cspParams As CspParameters)
パラメーター
- cspParams
- CspParameters
暗号化サービス プロバイダー (CSP) に渡すパラメーター。
こちらもご覧ください
適用対象
RNGCryptoServiceProvider(String)
RNGCryptoServiceProvider クラスの新しいインスタンスを初期化します。
public:
RNGCryptoServiceProvider(System::String ^ str);
public RNGCryptoServiceProvider(string str);
new System.Security.Cryptography.RNGCryptoServiceProvider : string -> System.Security.Cryptography.RNGCryptoServiceProvider
Public Sub New (str As String)
パラメーター
- str
- String
文字列入力。 このパラメーターは無視されます。
注釈
このメソッドは、 RNGCryptoServiceProvider クラスを直接初期化しません。 このメソッドの呼び出しは、 RNGCryptoServiceProvider(CspParameters) コンストラクターを呼び出し、 nullを渡すことと同じです。