[This is preliminary documentation and is subject to change.]
Tries to generate many consecutive Globally-Unique distributed ID (GDID) from the same authority for the supplied sequence name.
If the reserved block gets exhausted, then the returned ID array length may be less than requested
Namespace: NFX.DataAccessAssembly: NFX (in NFX.dll) Version: 3.0.0.1 (3.0.0.1)
GDID[] TryGenerateManyConsecutiveGDIDs(
string scopeName,
string sequenceName,
int gdidCount,
Nullable<ulong> vicinity = 1152921504606846975,
bool noLWM = false
)
GDID[] TryGenerateManyConsecutiveGDIDs(
string scopeName,
string sequenceName,
int gdidCount,
Nullable<ulong> vicinity = 1152921504606846975,
bool noLWM = false
)
Function TryGenerateManyConsecutiveGDIDs (
scopeName As String,
sequenceName As String,
gdidCount As Integer,
Optional vicinity As Nullable(Of ULong) = 1152921504606846975,
Optional noLWM As Boolean = false
) As GDID()
Function TryGenerateManyConsecutiveGDIDs (
scopeName As String,
sequenceName As String,
gdidCount As Integer,
Optional vicinity As Nullable(Of ULong) = 1152921504606846975,
Optional noLWM As Boolean = false
) As GDID()
array<GDID>^ TryGenerateManyConsecutiveGDIDs(
String^ scopeName,
String^ sequenceName,
int gdidCount,
Nullable<unsigned long long> vicinity = 1152921504606846975,
bool noLWM = false
)
array<GDID>^ TryGenerateManyConsecutiveGDIDs(
String^ scopeName,
String^ sequenceName,
int gdidCount,
Nullable<unsigned long long> vicinity = 1152921504606846975,
bool noLWM = false
)
abstract TryGenerateManyConsecutiveGDIDs :
scopeName : string *
sequenceName : string *
gdidCount : int *
?vicinity : Nullable<uint64> *
?noLWM : bool
(* Defaults:
let _vicinity = defaultArg vicinity 1152921504606846975
let _noLWM = defaultArg noLWM false
*)
-> GDID[]abstract TryGenerateManyConsecutiveGDIDs :
scopeName : string *
sequenceName : string *
gdidCount : int *
?vicinity : Nullable<uint64> *
?noLWM : bool
(* Defaults:
let _vicinity = defaultArg vicinity 1152921504606846975
let _noLWM = defaultArg noLWM false
*)
-> GDID[]Parameters
- scopeName
- Type:
System String
The name of scope where sequences are kept
- sequenceName
- Type: System String
The name of sequence within the scope for which ID to be obtained
- gdidCount
- Type: System Int32
How many Consecutive GDIDs from the same authority should the system try to reserve
- vicinity (Optional)
- Type: System Nullable UInt64
The location on ID counter scale, the authority may disregard this parameter
- noLWM (Optional)
- Type: System Boolean
When true, does not start async fetch of the next ID block while the current block reaches low-water-mark.
This may not be desired in some short-lived processes.
The provider may disregard this flag
Return Value
Type:
GDID The GDID[] instance which may have less elements than requested by gdidCount
