Guid.TryParseExact Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestawy:: netstandard.dll, System.Runtime.dll

Zestaw:: System.Runtime.dll

Zestaw:: netstandard.dll

Zestawy:: mscorlib.dll, System.Runtime.dll

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)	Konwertuje zakres znaków reprezentujący identyfikator GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie.
TryParseExact(String, String, Guid)	Konwertuje reprezentację ciągu identyfikatora GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie.

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Konwertuje zakres znaków reprezentujący identyfikator GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie.

public:
 static bool TryParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format, out Guid result);

static member TryParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * Guid -> bool

Public Shared Function TryParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), ByRef result As Guid) As Boolean

Parametry

input: ReadOnlySpan<Char>

Zakres tylko do odczytu zawierający znaki reprezentujące identyfikator GUID do konwersji.

format: ReadOnlySpan<Char>

Zakres tylko do odczytu zawierający znak reprezentujący jeden z następujących specyfikatorów, który wskazuje dokładny format używany podczas interpretowania input: "N", "D", "B", "P" lub "X".

result: Guid

Gdy ta metoda zwraca wartość , zawiera przeanalizowaną wartość. Jeśli metoda zwraca truewartość , result zawiera prawidłowy Guidelement . Jeśli metoda zwraca falsewartość , result jest równa Empty.

Zwraca

Boolean

true jeśli operacja analizy zakończyła się pomyślnie; w przeciwnym razie , false.

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard	2.1

TryParseExact(String, String, Guid)

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Konwertuje reprezentację ciągu identyfikatora GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie.

public:
 static bool TryParseExact(System::String ^ input, System::String ^ format, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParseExact(string input, string format, out Guid result);

public static bool TryParseExact(string? input, string? format, out Guid result);

static member TryParseExact : string * string * Guid -> bool

Public Shared Function TryParseExact (input As String, format As String, ByRef result As Guid) As Boolean

Parametry

input: String

Identyfikator GUID, który ma zostać przekształcony.

format: String

Jeden z następujących specyfikatorów wskazujący dokładny format używany podczas interpretowania input: "N", "D", "B", "P" lub "X".

result: Guid

Zwraca

Boolean

true jeśli operacja analizy zakończyła się pomyślnie; w przeciwnym razie , false.

Przykłady

Poniższy przykład wywołuje metodę ToString(String) z każdym z obsługiwanych specyfikatorów formatu w celu wygenerowania tablicy ciągów reprezentujących pojedynczy identyfikator GUID. Następnie są one przekazywane do TryParseExact metody , która pomyślnie analizuje ciąg zgodny ze specyfikatorem formatu "B".

// Define an array of all format specifiers.
string[] formats = { "N", "D", "B", "P", "X" };
Guid guid = Guid.NewGuid();
// Create an array of valid Guid string representations.
var stringGuids = new string[formats.Length];
for (int ctr = 0; ctr < formats.Length; ctr++)
    stringGuids[ctr] = guid.ToString(formats[ctr]);

// Parse the strings in the array using the "B" format specifier.
foreach (var stringGuid in stringGuids)
{
    if (Guid.TryParseExact(stringGuid, "B", out var newGuid))
        Console.WriteLine($"Successfully parsed {stringGuid}");
    else
        Console.WriteLine($"Unable to parse '{stringGuid}'");
}

// The example displays output similar to the following:
//
//    Unable to parse 'c0fb150f6bf344df984a3a0611ae5e4a'
//    Unable to parse 'c0fb150f-6bf3-44df-984a-3a0611ae5e4a'
//    Successfully parsed {c0fb150f-6bf3-44df-984a-3a0611ae5e4a}
//    Unable to parse '(c0fb150f-6bf3-44df-984a-3a0611ae5e4a)'
//    Unable to parse '{0xc0fb150f,0x6bf3,0x44df,{0x98,0x4a,0x3a,0x06,0x11,0xae,0x5e,0x4a}}'

open System

// Define an array of all format specifiers.
let formats = [| "N"; "D"; "B"; "P"; "X" |]

let guid = Guid.NewGuid()

// Create an array of valid Guid string representations.
let stringGuids = 
    Array.map guid.ToString formats

// Parse the strings in the array using the "B" format specifier.
for stringGuid in stringGuids do
    match Guid.TryParseExact(stringGuid, "B") with
    | true, newGuid ->
        printfn $"Successfully parsed {stringGuid}"
    | _ ->
        printfn $"Unable to parse '{stringGuid}'"

// The example displays output similar to the following:
//
//    Unable to parse 'c0fb150f6bf344df984a3a0611ae5e4a'
//    Unable to parse 'c0fb150f-6bf3-44df-984a-3a0611ae5e4a'
//    Successfully parsed {c0fb150f-6bf3-44df-984a-3a0611ae5e4a}
//    Unable to parse '(c0fb150f-6bf3-44df-984a-3a0611ae5e4a)'
//    Unable to parse '{0xc0fb150f,0x6bf3,0x44df,{0x98,0x4a,0x3a,0x06,0x11,0xae,0x5e,0x4a}}'

Module Example
   Public Sub Main()
      ' Define an array of all format specifiers.
      Dim formats() As String = { "N", "D", "B", "P", "X" }
      Dim guid As Guid = Guid.NewGuid()
      ' Create an array of valid Guid string representations.
      Dim stringGuids(formats.Length - 1) As String
      For ctr As Integer = 0 To formats.Length - 1
         stringGuids(ctr) = guid.ToString(formats(ctr))
      Next

      ' Try to parse the strings in the array using the "B" format specifier.
      For Each stringGuid In stringGuids
         Dim newGuid As Guid
         If Guid.TryParseExact(stringGuid, "B", newGuid) Then
            Console.WriteLine("Successfully parsed {0}", stringGuid)
         Else
            Console.WriteLine("Unable to parse '{0}'", stringGuid)
         End If   
      Next      
   End Sub
End Module
' The example displays the following output:
'    Unable to parse 'c0fb150f6bf344df984a3a0611ae5e4a'
'    Unable to parse 'c0fb150f-6bf3-44df-984a-3a0611ae5e4a'
'    Successfully parsed {c0fb150f-6bf3-44df-984a-3a0611ae5e4a}
'    Unable to parse '(c0fb150f-6bf3-44df-984a-3a0611ae5e4a)'
'    Unable to parse '{0xc0fb150f,0x6bf3,0x44df,{0x98,0x4a,0x3a,0x06,0x11,0xae,0x5e,0x4a}}'

Uwagi

Ta metoda wymaga przekonwertowania ciągu w taki sposób, aby był dokładnie w formacie określonym przez parametr, po usunięciu format znaków wiodących i końcowych białych znaków. Zwraca wartość false , jeśli input jest null lub nie ma formatu określonego przez format, i nie zgłasza wyjątku.

W poniższej tabeli przedstawiono akceptowane specyfikatory formatu dla parametru format . Znak „0” reprezentuje cyfrę. Łączniki („-”), nawiasy klamrowe („{”, „}”) i nawiasy („(”, „)”) są wyświetlane jak pokazano.

Specyfikator	Format parametru `input`
N	32 cyfry: 00000000000000000000000000000000
D	32 cyfry rozdzielone łącznikami: 00000000-0000-0000-0000-000000000000
B	32 cyfry rozdzielone łącznikami, ujęte w nawiasach klamrowych: {00000000-0000-0000-0000-000000000000}
P	32 cyfry rozdzielone łącznikami, ujęte w nawiasach: (00000000-0000-0000-0000-000000000000)
X	Cztery wartości szesnastkowe zawarte w nawiasach klamrowych, gdzie czwarta wartość jest podzbiorem ośmiu wartości szesnastkowych również ujętych w nawiasy klamrowe: {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}

Zobacz też

ParseExact(String, String)

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Udostępnij za pośrednictwem

Guid.TryParseExact Metoda

Definicja

Przeciążenia

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)

Parametry

Zwraca

Dotyczy

TryParseExact(String, String, Guid)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby