43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
# ❄ idgenerator-C#
|
||
|
||
## 运行环境
|
||
|
||
.NET Standard 2.0+
|
||
（支持：.net framework4.6.1+/.net core 2.0+/.net5/.net6+/mono5.4+/Unity 2018+/Xamarin/）
|
||
|
||
## 引用 nuget 包
|
||
```xml
|
||
<PackageReference Include="Yitter.IdGenerator" Version="1.0.*" />
|
||
```
|
||
或者使用nuget CLI时
|
||
```shell
|
||
nuget install Yitter.IdGenerator
|
||
```
|
||
更多引入方式请点击查看: [nuget.org/packages/Yitter.IdGenerator](https://www.nuget.org/packages/Yitter.IdGenerator)
|
||
|
||
## 调用示例（C#）
|
||
|
||
第1步，**全局** 初始化（应用程序启动时执行一次）：
|
||
```cs
|
||
// 创建 IdGeneratorOptions 对象，可在构造函数中输入 WorkerId：
|
||
var options = new IdGeneratorOptions(Your_Unique_Worker_Id);
|
||
// options.WorkerIdBitLength = 10; // 默认值6，限定 WorkerId 最大值为2^6-1，即默认最多支持64个节点。
|
||
// options.SeqBitLength = 6; // 默认值6，限制每毫秒生成的ID个数。若生成速度超过5万个/秒，建议加大 SeqBitLength 到 10。
|
||
// options.BaseTime = Your_Base_Time; // 如果要兼容老系统的雪花算法，此处应设置为老系统的BaseTime。
|
||
// ...... 其它参数参考 IdGeneratorOptions 定义。
|
||
|
||
// 保存参数（务必调用，否则参数设置不生效）：
|
||
YitIdHelper.SetIdGenerator(options);
|
||
|
||
// 以上过程只需全局一次，且应在生成ID之前完成。
|
||
```
|
||
|
||
第2步，生成ID：
|
||
```cs
|
||
// 初始化后，在任何需要生成ID的地方，调用以下方法：
|
||
var newId = YitIdHelper.NextId();
|
||
```
|
||
|
||
|
||
|