Guid class
Diese Klasse stellt einen global eindeutigen Bezeichner dar, wie in IETF RFC 4122 beschrieben.
Hinweise
Die Eingabezeichenfolge wird normalisiert und überprüft, was wichtige Garantien bietet, die anderen Code vereinfachen, der mit der GUID funktioniert. Diese Klasse bietet auch grundlegende Unterstützung für das Generieren einer pseudo-zufälligen GUID. Beachten Sie jedoch, dass die Eindeutigkeit von der Browserfunktion Math.random()
abhängt und für einige Anwendungen möglicherweise nicht geeignet ist.
Weitere Informationen finden Sie unter RFC4122 .
Eigenschaften
empty | Gibt eine neue leere GUID-Instanz zurück. |
Methoden
equals(guid) | Vergleicht diese Instanz mit einer anderen GUID-Instanz |
is |
Gibt an, ob eine GUID gültig ist, d. h. ob sie erfolgreich von |
new |
Gibt eine neue GUID-instance mit einer pseudo-zufällig generierten GUID zurück, gemäß dem UUID-Algorithmus der Version 4 aus RFC 4122. |
parse(guid |
Analysiert die Eingabezeichenfolge zum Erstellen eines neuen GUID-Objekts. Wenn die Zeichenfolge nicht analysiert werden kann, wird ein Fehler ausgelöst. |
to |
Gibt eine Zeichenfolgendarstellung der GUID zurück. |
try |
Versucht, die Eingabezeichenfolge zum Erstellen eines neuen GUID-Objekts zu analysieren. Wenn die Zeichenfolge nicht analysiert werden kann, wird undefiniert zurückgegeben. |
Details zur Eigenschaft
empty
Details zur Methode
equals(guid)
Vergleicht diese Instanz mit einer anderen GUID-Instanz
equals(guid: Guid): boolean;
Parameter
- guid
- Guid
Gibt zurück
boolean
True, wenn diese Instanz und das angegebene Guid-Objekt den gleichen Wert darstellen.
isValid(guid)
Gibt an, ob eine GUID gültig ist, d. h. ob sie erfolgreich von Guid.tryParse()
analysiert werden würde. Diese Funktion ist kostengünstiger als Guid.tryParse()
, da sie kein Guid-Objekt erstellt.
static isValid(guid: string | undefined | null): boolean;
Parameter
- guid
-
string | undefined | null
Die eingegebene Zeichenfolge.
Gibt zurück
boolean
„True“, wenn die GUID gültig ist.
newGuid(randomNumberGenerator)
Gibt eine neue GUID-instance mit einer pseudo-zufällig generierten GUID zurück, gemäß dem UUID-Algorithmus der Version 4 aus RFC 4122.
static newGuid(randomNumberGenerator?: IRandomNumberGenerator): Guid;
Parameter
- randomNumberGenerator
- IRandomNumberGenerator
Gibt zurück
Ein neues eindeutiges GUID-Objekt
parse(guidString)
Analysiert die Eingabezeichenfolge zum Erstellen eines neuen GUID-Objekts. Wenn die Zeichenfolge nicht analysiert werden kann, wird ein Fehler ausgelöst.
static parse(guidString: string | undefined | null): Guid;
Parameter
- guidString
-
string | undefined | null
Die eingegebene Zeichenfolge.
Gibt zurück
Ein gültiges GUID-Objekt.
Hinweise
Beispielsyntaxen, die von dieser Funktion akzeptiert werden:
"d5369f3bbd7a412a9c0f7f0650bb5489"
"d5369f3b-bd7a-412a-9c0f-7f0650bb5489"
"{d5369f3b-bd7a-412a-9c0f-7f0650bb5489}"
"/Guid(d5369f3b-bd7a-412a-9c0f-7f0650bb5489)/"
toString()
Gibt eine Zeichenfolgendarstellung der GUID zurück.
toString(): string;
Gibt zurück
string
Den GUID-Wert in klein geschriebenen Hexadezimalen ohne geschweifte Klammern.
Beispiel: 'd5369f3b-bd7a-412a-9c0f-7f0650bb5489'
tryParse(guid)
Versucht, die Eingabezeichenfolge zum Erstellen eines neuen GUID-Objekts zu analysieren. Wenn die Zeichenfolge nicht analysiert werden kann, wird undefiniert zurückgegeben.
static tryParse(guid: string | undefined | null): Guid | undefined;
Parameter
- guid
-
string | undefined | null
Die eingegebene Zeichenfolge.
Gibt zurück
Guid | undefined
Das GUID-Objekt oder undefiniert wenn die Zeichenfolge nicht analysiert werden konnte.
Hinweise
Beispielsyntaxen, die von dieser Funktion akzeptiert werden:
"d5369f3bbd7a412a9c0f7f0650bb5489"
"d5369f3b-bd7a-412a-9c0f-7f0650bb5489"
"{d5369f3b-bd7a-412a-9c0f-7f0650bb5489}"
"/Guid(d5369f3b-bd7a-412a-9c0f-7f0650bb5489)/"