Guid.TryParse Methode

Definition

Überlädt

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Versucht, eine Spanne von Zeichen in einen Wert zu analysieren.

TryParse(String, IFormatProvider, Guid)

Versucht, eine Zeichenfolge in einen Wert zu analysieren.

TryParse(ReadOnlySpan<Char>, Guid)

Konvertiert die angegebene schreibgeschützte Spanne von Zeichen, die die Darstellung einer GUID enthält, in die entsprechende Guid-Struktur.

TryParse(String, Guid)

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Versucht, eine Spanne 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 s bereitstellt.

result
Guid

Wenn diese Methode zurückgibt, enthält das Ergebnis der erfolgreichen sAnalyse oder einen undefinierten Wert bei Einem Fehler.

Gibt zurück

true , wenn s erfolgreich analysiert wurde, falseandernfalls .

Gilt für:

TryParse(String, IFormatProvider, Guid)

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 s bereitstellt.

result
Guid

Wenn diese Methode zurückgibt, enthält das Ergebnis der erfolgreichen s Analyse oder einen nicht definierten Wert bei Einem Fehler.

Gibt zurück

true , wenn s erfolgreich analysiert wurde, falseandernfalls .

Gilt für:

TryParse(ReadOnlySpan<Char>, Guid)

Konvertiert die angegebene schreibgeschützte Spanne von Zeichen, die die Darstellung einer GUID enthält, 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>

Eine Spanne, die die Zeichen enthält, die die zu konvertierende GUID darstellen.

result
Guid

Wenn diese Methode zurückgegeben wird, enthält sie den analysierten Wert. Wenn die Methode true zurückgibt, enthält result gültiges Guid. Wenn die Methode false zurückgibt, gleicht resultEmpty.

Gibt zurück

true, wenn der Analysevorgang erfolgreich war, andernfalls false.

Gilt für:

TryParse(String, Guid)

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 true zurückgibt, enthält result gültiges Guid. Wenn die Methode false zurückgibt, gleicht 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 Werte zu Guid 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ückgibt false , wenn inputnull in einem erkannten Format vorliegt oder nicht, und löst keine Ausnahme aus. Es schneidet alle führenden oder nachfolgenden Leerzeichen von input und konvertiert Zeichenfolgen in einem der fünf Formate, die von den ToString(String) Methoden und ToString(String, IFormatProvider) erkannt werden, wie in der folgenden Tabelle gezeigt.

Bezeichner 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, in Klammern eingeschlossen (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 ebenfalls in geschweifte Klammern eingeschlossen ist. {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Weitere Informationen

Gilt für: