Guid.TryParse Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Überlädt

TryParse(ReadOnlySpan<Char>, Guid)	Konvertiert den angegebenen schreibgeschützten Bereich von Zeichen, die die Darstellung einer GUID enthalten, in die entsprechende Guid Struktur.
TryParse(String, Guid)	Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid Struktur.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	Versucht, einen Bereich von Zeichen in einen Wert zu analysieren.
TryParse(String, IFormatProvider, Guid)	Versucht, eine Zeichenfolge in einen Wert zu analysieren.

TryParse(ReadOnlySpan<Char>, Guid)

Quelle:

Guid.cs

Konvertiert den angegebenen schreibgeschützten Bereich von Zeichen, die die Darstellung einer GUID enthalten, in die entsprechende Guid Struktur.

C#

public static bool TryParse(ReadOnlySpan<char> input, out Guid result);

Parameter

input

ReadOnlySpan<Char>

Ein Bereich mit den Zeichen, die die zu konvertierende GUID darstellen.

result

Guid

Wenn diese Methode zurückgegeben wird, enthält sie den analysierten Wert. Wenn die Methode truezurückgibt, enthält result eine gültige Guid. Wenn die Methode falsezurückgibt, entspricht resultEmpty.

Gibt zurück

Boolean

true, wenn der Analysevorgang erfolgreich war; andernfalls false.

TryParse(String, Guid)

Quelle:

Guid.cs

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid Struktur.

C#

public static bool TryParse(string? input, out Guid result);

Parameter

input

String

Eine Zeichenfolge, die die zu konvertierende GUID enthält.

result

Guid

Wenn diese Methode zurückgegeben wird, enthält sie den analysierten Wert. Wenn die Methode truezurückgibt, enthält result eine gültige Guid. Wenn die Methode falsezurückgibt, entspricht resultEmpty.

Gibt zurück

Boolean

true, wenn der Analysevorgang erfolgreich war; andernfalls false.

Beispiele

Im folgenden Beispiel wird eine neue GUID erstellt, in drei separate Zeichenfolgendarstellungen konvertiert, indem die ToString(String)-Methode mit den Formatbezeichnern "B", "D" und "X" aufgerufen wird. Anschließend wird die TryParse Methode aufgerufen, um die Zeichenfolgen wieder in Guid Werte zu konvertieren.

C#

Guid originalGuid = Guid.NewGuid();
// Create an array of string representations of the GUID.
string[] stringGuids = { originalGuid.ToString("B"),
                         originalGuid.ToString("D"),
                         originalGuid.ToString("X") };

// Parse each string representation.
foreach (var stringGuid in stringGuids)
{
    if (Guid.TryParse(stringGuid, out var newGuid))
        Console.WriteLine($"Converted {stringGuid} to a Guid");
    else
        Console.WriteLine($"Unable to convert {stringGuid} to a Guid");
}

// The example displays output similar to the following:
//
//    Converted {81a130d2-502f-4cf1-a376-63edeb000e9f} to a Guid
//    Converted 81a130d2-502f-4cf1-a376-63edeb000e9f to a Guid
//    Converted {0x81a130d2,0x502f,0x4cf1,{0xa3,0x76,0x63,0xed,0xeb,0x00,0x0e,0x9f}} to a Guid

Hinweise

Diese Methode ähnelt der Parse-Methode, mit der Ausnahme, dass sie nicht die analysierte GUID zurückgeben, sondern false zurückgibt, wenn input in einem erkannten Format null ist oder nicht, und löst keine Ausnahme aus. Sie schneidet führende oder nachfolgende Leerzeichen von input ab und konvertiert Zeichenfolgen in einem der fünf Formate, die von den methoden ToString(String) und ToString(String, IFormatProvider) erkannt werden, wie in der folgenden Tabelle dargestellt.

Spezifikationssymbol	Beschreibung	Format
N	32 Ziffern	00000000000000000000000000000000
D	32 Ziffern getrennt durch Bindestriche	00000000-0000-0000-0000-000000000000
B	32 Ziffern getrennt durch Bindestriche, eingeschlossen in geschweifte Klammern	{00000000-0000-0000-0000-000000000000}
P	32 Ziffern getrennt durch Bindestriche, eingeschlossen in Klammern	(00000000-0000-0000-0000-000000000000)
X	Vier hexadezimale Werte, die in geschweifte Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die auch in geschweifte Klammern eingeschlossen sind	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Weitere Informationen

• Parse(String)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Quelle:

Guid.cs

Versucht, einen Bereich von Zeichen in einen Wert zu analysieren.

C#

public static bool TryParse(ReadOnlySpan<char> s, IFormatProvider? provider, out Guid result);

Parameter

s

ReadOnlySpan<Char>

Die Spanne der zu analysierenden Zeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu sbereitstellt.

result

Guid

Wenn diese Methode zurückgegeben wird, enthält das Ergebnis der erfolgreichen Analyse soder eines nicht definierten Werts für fehler.

Gibt zurück

Boolean

true, wenn s erfolgreich analysiert wurde; andernfalls false.

TryParse(String, IFormatProvider, Guid)

Quelle:

Guid.cs

Versucht, eine Zeichenfolge in einen Wert zu analysieren.

C#

public static bool TryParse(string? s, IFormatProvider? provider, out Guid result);

Parameter

s

String

Die zu analysierende Zeichenfolge.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu sbereitstellt.

result

Guid

Wenn diese Methode zurückgegeben wird, enthält das Ergebnis der erfolgreichen Analyse s oder eines nicht definierten Werts für fehler.

Gibt zurück

Boolean

true, wenn s erfolgreich analysiert wurde; andernfalls false.