Guid.TryParse Methode

Definition

Überlädt

TryParse(ReadOnlySpan<Char>, Guid)

Konvertiert die angegebene schreibgeschützte Spanne von Zeichen, die die Darstellung einer GUID enthält, in die entsprechende Guid-Struktur.Converts the specified read-only span of characters containing the representation of a GUID to the equivalent Guid structure.

TryParse(String, Guid)

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur.Converts the string representation of a GUID to the equivalent Guid structure.

TryParse(ReadOnlySpan<Char>, Guid)

Konvertiert die angegebene schreibgeschützte Spanne von Zeichen, die die Darstellung einer GUID enthält, in die entsprechende Guid-Struktur.Converts the specified read-only span of characters containing the representation of a GUID to the equivalent Guid structure.

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.A span containing the characters representing the GUID to convert.

result
Guid

Eine Guid-Instanz, die den analysierten Wert enthält.A Guid instance to contain the parsed value. Wenn die Methode true zurückgibt, enthält result gültiges Guid.If the method returns true, result contains a valid Guid. Wenn die Methode false zurückgibt, gleicht resultEmpty.If the method returns false, result equals Empty.

Gibt zurück

true, wenn der Analysevorgang erfolgreich war, andernfalls false.true if the parse operation was successful; otherwise, false.

TryParse(String, Guid)

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur.Converts the string representation of a GUID to the equivalent Guid structure.

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::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.A string containing the GUID to convert.

result
Guid

Eine Guid-Instanz, die den analysierten Wert enthält.A Guid instance to contain the parsed value. Wenn die Methode true zurückgibt, enthält result gültiges Guid.If the method returns true, result contains a valid Guid. Wenn die Methode false zurückgibt, gleicht resultEmpty.If the method returns false, result equals Empty.

Gibt zurück

true, wenn der Analysevorgang erfolgreich war, andernfalls false.true if the parse operation was successful; otherwise, false.

Beispiele

Im folgenden Beispiel wird eine neue GUID erstellt und in drei separate Zeichen folgen Darstellungen konvertiert, indem die ToString(String)-Methode mit den Formatbezeichner"B", "D" und "X" aufgerufen wird. Anschließend wird die TryParse-Methode aufgerufen, um die Zeichen folgen zurück in Guid Werte zu konvertieren.The following example creates a new GUID, converts it to three separate string representations by calling the ToString(String) method with the "B", "D", and "X" format specifiers, and then calls the TryParse method to convert the strings back to Guid values.

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
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 anstelle der analysierten GUID false zurückgegeben wird, wenn input null ist oder nicht in einem erkannten Format vorliegt und keine Ausnahme auslöst.This method is like the Parse method, except that instead of returning the parsed GUID, it returns false if input is null or not in a recognized format, and doesn't throw an exception. Dabei werden alle führenden oder nachfolgenden Leerzeichen aus input entfernt und Zeichen folgen in einem der fünf Formate konvertiert, die von den Methoden ToString(String) und ToString(String, IFormatProvider) erkannt werden, wie in der folgenden Tabelle dargestellt.It trims any leading or trailing white space from input and converts strings in any of the five formats recognized by the ToString(String) and ToString(String, IFormatProvider) methods, as shown in the following table.

BezeichnerSpecifier BeschreibungDescription FormatFormat
N 32 Ziffern32 digits 0000000000000000000000000000000000000000000000000000000000000000
D 32 Ziffern durch Bindestriche getrennt32 digits separated by hyphens 00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 Ziffern durch Bindestriche getrennt, eingeschlossen in geschweiften Klammern32 digits separated by hyphens, enclosed in braces {00000000-0000-0000-0000-000000000000}
P 32 Ziffern durch Bindestriche getrennt, eingeschlossen in Klammern32 digits separated by hyphens, enclosed in parentheses (00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X Vier hexadezimale Werte, die in geschweiften Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht hexadezimal Werten ist, die ebenfalls in geschweiften Klammern eingeschlossen sindFour hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Siehe auch

Gilt für: