Teilen über


Guid.TryParse Methode

Definition

Ü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
Quelle:
Guid.cs
Quelle:
Guid.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParse (ReadOnlySpan<char> input, out Guid result);
static member TryParse : ReadOnlySpan<char> * Guid -> bool
Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As Guid) As Boolean

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

true, wenn der Analysevorgang erfolgreich war; andernfalls false.

Gilt für:

TryParse(String, Guid)

Quelle:
Guid.cs
Quelle:
Guid.cs
Quelle:
Guid.cs

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid Struktur.

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParse (string input, out Guid result);
public static bool TryParse (string? input, out Guid result);
static member TryParse : string * Guid -> bool
Public Shared Function TryParse (input As String, ByRef result As Guid) As Boolean

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

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.

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
open System

let originalGuid = Guid.NewGuid()

// Create an array of string representations of the GUID.
let stringGuids =
    [| originalGuid.ToString "B"
       originalGuid.ToString "D"
       originalGuid.ToString "X" |]

// Parse each string representation.
for stringGuid in stringGuids do
    match Guid.TryParse stringGuid with
    | true, newGuid ->
        printfn $"Converted {stringGuid} to a Guid"
    | _ ->
        printfn $"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
Module Example
   Public Sub Main()
      Dim originalGuid As Guid = Guid.NewGuid()
      ' Create an array of string representations of the GUID.
      Dim stringGuids() As String = { originalGuid.ToString("B"),
                                      originalGuid.ToString("D"),
                                      originalGuid.ToString("X") }
      
      ' Parse each string representation.
      Dim newGuid As Guid
      For Each stringGuid In stringGuids
         If Guid.TryParse(stringGuid, newGuid) Then
            Console.WriteLine("Converted {0} to a Guid", stringGuid)
         Else
            Console.WriteLine("Unable to convert {0} to a Guid", 
                              stringGuid)
         End If     
      Next                                      
   End Sub
End Module
' The example displays the following output:
'    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

Gilt für:

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Quelle:
Guid.cs
Quelle:
Guid.cs
Quelle:
Guid.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = ISpanParsable<Guid>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out Guid result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * Guid -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Guid) As Boolean

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

true, wenn s erfolgreich analysiert wurde; andernfalls false.

Gilt für:

TryParse(String, IFormatProvider, Guid)

Quelle:
Guid.cs
Quelle:
Guid.cs
Quelle:
Guid.cs

Versucht, eine Zeichenfolge in einen Wert zu analysieren.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = IParsable<Guid>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out Guid result);
static member TryParse : string * IFormatProvider * Guid -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Guid) As Boolean

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

true, wenn s erfolgreich analysiert wurde; andernfalls false.

Gilt für: