Guid.TryParse Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ü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

Boolean

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

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.

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

Parse(String)

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

Boolean

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

Boolean

true, wenn s erfolgreich analysiert wurde; andernfalls false.

Gilt für:

Teilen über

Guid.TryParse Methode

Definition

Überlädt

TryParse(ReadOnlySpan<Char>, Guid)

Parameter

Gibt zurück

Gilt für:

TryParse(String, Guid)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Parameter

Gibt zurück

Gilt für:

TryParse(String, IFormatProvider, Guid)

Parameter

Gibt zurück

Gilt für:

Zusätzliche Ressourcen