Guid.TryParse Methode

Definition

Namespace:: System

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assemblys:: mscorlib.dll, System.Runtime.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

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

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Quelle:: Guid.cs

Quelle:: Guid.cs

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

result: Guid

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

Gibt zurück

Boolean

truewenn s erfolgreich analysiert wurde; andernfalls . false

Gilt für:

TryParse(ReadOnlySpan<Byte>, Guid)

Quelle:: Guid.cs

Quelle:: Guid.cs

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParse(ReadOnlySpan<byte> utf8Text, out Guid result);

static member TryParse : ReadOnlySpan<byte> * Guid -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Guid) As Boolean

Parameter

utf8Text: ReadOnlySpan<Byte>

result: Guid

Gibt zurück

Boolean

Gilt für:

TryParse(ReadOnlySpan<Char>, Guid)

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

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

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 zurückgegeben wird true, result enthält sie ein gültiges Guid. Wenn die Methode zurückgegeben wird false, result entspricht Empty.

Gibt zurück

Boolean

truewenn der Analysevorgang erfolgreich war; andernfalls . false

Gilt für:

TryParse(String, Guid)

Quelle:: Guid.cs

Quelle:: Guid.cs

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

truewenn 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 und anschließend die TryParse Methode aufgerufen wird, 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 sondern ob input sie sich in einem erkannten Format befindet null 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) und ToString(String, IFormatProvider) den Methoden erkannt werden, wie in der folgenden Tabelle dargestellt.

Spezifikationssymbol	Description	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<Byte>, IFormatProvider, Guid)

Quelle:: Guid.cs

Quelle:: Guid.cs

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

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = IUtf8SpanParsable<Guid>::TryParse;

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

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * Guid -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Guid) As Boolean

Parameter

utf8Text: ReadOnlySpan<Byte>

Die Spanne von UTF-8 Zeichen, die analysiert werden sollen.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text.

result: Guid

Enthält das Ergebnis einer erfolgreichen Analyse oder eines nicht definierten Werts utf8Text für fehler.

Gibt zurück

Boolean

truewenn utf8Text erfolgreich analysiert wurde; andernfalls . false

Gilt für:

TryParse(String, IFormatProvider, Guid)

Quelle:: Guid.cs

Quelle:: Guid.cs

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

result: Guid

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

Gibt zurück

Boolean

truewenn s erfolgreich analysiert wurde; andernfalls . false

Gilt für:

Feedback

War diese Seite hilfreich?