shortid 3.0.1

Install-Package shortid -Version 3.0.1
dotnet add package shortid --version 3.0.1
<PackageReference Include="shortid" Version="3.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add shortid --version 3.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: shortid, 3.0.1"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install shortid as a Cake Addin
#addin nuget:?package=shortid&version=3.0.1

// Install shortid as a Cake Tool
#tool nuget:?package=shortid&version=3.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

shortid

Build Status License: MIT NuGet Badge Coverage Status

About ShortId

A CSharp library to generate completely random short id's. They can be used as primary keys or unique identifiers. This library is different in that you can specify the length of the ids to be generated. This library is thread-safe and can generate millions of unique ids across multiple threads.

Getting Started

To make use of the shortid, add it to your project via the Nuget package manager UI or console via this command:

Package Manager
Install-Package shortid
.NET CLI
> dotnet add package shortid
PackageReference
<PackageReference Include="shortid" />

Usage

Add the following using command to the top of your csharp code file:

using shortid;
using shortid.Configuration;

This gives your code access the classes and methods of the shortid namespace.

To generate a unique id of any length between 8 and 15, you call the Generate method without parameters.

string id = ShortId.Generate();
// id = KXTR_VzGVUoOY

If you want to include numbers in the generated id, then you call the Generate method with options indicating your preference.

var options = new GenerationOptions
{
  UseNumbers = true
};
string id = ShortId.Generate(options);
// id = O_bBY-YUkJg

If you do not want special characters i.e _ and - in your generated id, then call the Generate method with options indicating your preferences.

var options = new GenerationOptions
{
  UseSpecialCharacters = false
};
string id = ShortId.Generate(options);
// id = waBfk3z

If you want to specify the length of the generated id, call the Generate method with options indicating your preferences.

var options = new GenerationOptions
{
  Length = 9
};
string id = ShortId.Generate(options);
// id = M-snXzBkj

Customize ShortId

ShortId has several features that help with customizing the ids generated. Characters sets can be introduced and the random number generator can be seeded.

To change the character set in use, run the following:

string characters = "ⒶⒷⒸⒹⒺⒻⒼⒽⒾⒿⓀⓁⓂⓃⓄⓅⓆⓇⓈⓉⓊⓋⓌⓍⓎⓏⓐⓑⓒⓓⓔⓕⓖⓗⓘⓙⓚⓛⓜⓝⓞⓟⓠⓡⓢⓣⓤⓥⓦⓧⓨⓩ①②③④⑤⑥⑦⑧⑨⑩⑪⑫"; //whatever you want;
ShortId.SetCharacters(characters);

NOTE: the new character set must not be null, an empty string or whitespace. Also, all whitespace and duplicate characters would be removed, finally the character set cannot be less than 50 characters.

ShortId also allows the seed for the random number generator to be set.

To set the seed, run the following:

int seed = 1939048828;
ShortId.SetSeed(seed);

Finally, ShortId allows for all customizations to be reset using the following:

ShortId.Reset();
  • .NETStandard 1.0

    • No dependencies.

NuGet packages (10)

Showing the top 5 NuGet packages that depend on shortid:

Package Downloads
kotori-core

Kotori core library.

Programatica.Framework.Mvc

Development framework accelarator

Yamf.Multitenancy

Package Description

fc-messaging-utils

Package Description

fc-corelation-id-manager

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.1 77,114 4/11/2021
3.0.0 126,964 8/27/2020
2.0.4 15,550 8/26/2020
2.0.3 51,800 7/4/2020
2.0.2 2,051 6/29/2020
2.0.1 61,392 3/26/2020
2.0.0 320,737 3/9/2018
1.0.4 3,790 2/6/2018
1.0.3 8,197 11/27/2017
1.0.2 5,642 7/5/2017
1.0.1 654 6/13/2017
1.0.0 681 6/10/2017

- add net5 support