[C#] Helper 的封裝 -- RandomHelper

 1 using System;
 2 
 3 namespace Wen.Helpers
 4 {
 5     /// <summary>
 6     /// 隨機數助手
 7     /// </summary>
 8     public sealed class RandomHelper
 9     {
10         /// <summary>
11         /// 字元集合（去掉 0oO 這幾個容易混淆的字元）
12         /// </summary>
13         private const string CharSet = "123456789abcdefghijklmnpqrstuvwxyzABCDEFGHIJKLMNPQRSTUVWXYZ~!@#$%^&*()_+|" ;
14 
15         private static readonly Random Random = new Random ();
16 
17         #region Next
18 
19         /// <summary>
20         /// 返回非負隨機數
21         /// </summary>
22         /// <returns> 大於等於零且小於 System.Int32.MaxValue 的 32 位帶符號整數 </returns>
23         public static int Next()
24         {
25             return Random.Next();
26         }
27 
28         /// <summary>
29         /// 返回一個指定範圍內的隨機數
30         /// </summary>
31         /// <param name="maxValue"> 要生成的隨機數的上限（隨機數不能取該上限值）。maxValue 必須大於或等於零 </param>
32         /// <returns>
33         /// 大於等於零且小於 maxValue 的 32 位帶符號整數，即：返回值的範圍通常包括零但不包括 maxValue。 不過，如果 maxValue 等於零，則返回 maxValue。
34         /// </returns>
35         public static int Next( int maxValue)
36         {
37             return Random.Next(maxValue);
38         }
39 
40         /// <summary>
41         /// 返回一個指定範圍內的隨機數
42         /// </summary>
43         /// <param name="minValue"> 返回的隨機數的下界（隨機數可取該下界值） </param>
44         /// <param name="maxValue"> 返回的隨機數的上界（隨機數不能取該上界值）。 maxValue 必須大於或等於 minValue</param>
45         /// <returns>
46         /// 一個大於等於 minValue 且小於 maxValue 的 32 位帶符號整數，即：返回的值範圍包括 minValue 但不包括 maxValue。
47         /// 如果 minValue 等於 maxValue，則返回 minValue。
48         /// </returns>
49         public static int Next( int minValue, int maxValue)
50         {
51             return Random.Next(minValue, maxValue);
52         }
53 
54         #endregion Next
55 
56         /// <summary>
57         /// 返回一個介於 0.0 和 1.0 之間的隨機數
58         /// </summary>
59         /// <returns> 大於等於 0.0 並且小於 1.0 的雙精度浮點數 </returns>
60         public static double NextDouble()
61         {
62             return Random.NextDouble();
63         }
64 
65         /// <summary>
66         /// 返回一個隨機字元串
67         /// </summary>
68         /// <param name="length"> 字元串長度 </param>
69         /// <returns></returns>
70         public static string NextString( int length)
71         {
72             var arr = new char[length];
73 
74             for (var i = 0; i < length; i++)
75             {
76                 var index = Random.Next(CharSet.Length);
77                 arr[i] = CharSet[index];
78             }
79 
80             return string .Join( "", arr);
81         }
82     }
83 }