Guid.ParseExact Metoda
Definicja
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
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>) |
Konwertuje znak obejmujący reprezentację identyfikatora GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie. |
ParseExact(String, String) |
Konwertuje reprezentację ciągu identyfikatora GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie. |
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
Konwertuje znak obejmujący reprezentację identyfikatora GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie.
public:
static Guid ParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format);
public static Guid ParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format);
static member ParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> -> Guid
Public Shared Function ParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char)) As Guid
Parametry
- input
- ReadOnlySpan<Char>
Zakres tylko do odczytu zawierający znaki reprezentujące identyfikator GUID do konwersji.
- format
- ReadOnlySpan<Char>
Zakres znaków tylko do odczytu 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".
Zwraca
Struktura zawierająca wartość, która została przeanalizowana.
Uwagi
Metoda ParseExact wymaga zakresu znaków tylko do odczytu, aby przekonwertować wartość dokładnie w formacie określonym przez parametr, po usunięciu format
znaków wiodących i końcowych znaków odstępu. 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 szesnastkowe: 00000000000000000000000000000000 |
D | 32 cyfry szesnastkowe rozdzielone łącznikami: 00000000-0000-0000-0000-000000000000 |
B | 32 cyfry szesnastkowe oddzielone łącznikami, ujęte w nawiasy klamrowe: {00000000-0000-0000-0000-000000000000} |
P | 32 cyfry szesnastkowe rozdzielone łącznikami, ujęte w nawiasy: (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}} |
Dotyczy
ParseExact(String, String)
Konwertuje reprezentację ciągu identyfikatora GUID na równoważną Guid strukturę, pod warunkiem, że ciąg jest w określonym formacie.
public:
static Guid ParseExact(System::String ^ input, System::String ^ format);
public static Guid ParseExact (string input, string format);
static member ParseExact : string * string -> Guid
Public Shared Function ParseExact (input As String, format As String) As Guid
Parametry
- input
- String
Identyfikator GUID, który ma zostać przekształcony.
- format
- String
Jeden z następujących specyfikatorów, który wskazuje dokładny format używany podczas interpretowania input
: "N", "D", "B", "P" lub "X".
Zwraca
Struktura zawierająca wartość, która została przeanalizowana.
Wyjątki
input
lub format
to null
.
input
nie jest w formacie określonym przez format
.
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 ParseExact metody, która pomyślnie analizuje tylko ciąg zgodny z 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)
{
try
{
Guid newGuid = Guid.ParseExact(stringGuid, "B");
Console.WriteLine($"Successfully parsed {stringGuid}");
}
catch (ArgumentNullException)
{
Console.WriteLine("The string to be parsed is null.");
}
catch (FormatException)
{
Console.WriteLine($"Bad Format: {stringGuid}");
}
}
// The example displays output similar to the following:
//
// Bad Format: eb5c8c7d187a44e68afb81e854c39457
// Bad Format: eb5c8c7d-187a-44e6-8afb-81e854c39457
// Successfully parsed {eb5c8c7d-187a-44e6-8afb-81e854c39457}
// Bad Format: (eb5c8c7d-187a-44e6-8afb-81e854c39457)
// Bad Format: {0xeb5c8c7d,0x187a,0x44e6,{0x8a,0xfb,0x81,0xe8,0x54,0xc3,0x94,0x57}}
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
try
let newGuid = Guid.ParseExact(stringGuid, "B")
printfn $"Successfully parsed {stringGuid}"
with
| :? ArgumentNullException ->
printfn "The string to be parsed is null."
| :? FormatException ->
printfn $"Bad Format: {stringGuid}"
// The example displays output similar to the following:
//
// Bad Format: eb5c8c7d187a44e68afb81e854c39457
// Bad Format: eb5c8c7d-187a-44e6-8afb-81e854c39457
// Successfully parsed {eb5c8c7d-187a-44e6-8afb-81e854c39457}
// Bad Format: (eb5c8c7d-187a-44e6-8afb-81e854c39457)
// Bad Format: {0xeb5c8c7d,0x187a,0x44e6,{0x8a,0xfb,0x81,0xe8,0x54,0xc3,0x94,0x57}}
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
' Parse the strings in the array using the "B" format specifier.
For Each stringGuid In stringGuids
Try
Dim newGuid As Guid = Guid.ParseExact(stringGuid, "B")
Console.WriteLine("Successfully parsed {0}", stringGuid)
Catch e As ArgumentNullException
Console.WriteLine("The string to be parsed is null.")
Catch e As FormatException
Console.WriteLine("Bad Format: {0}", stringGuid)
End Try
Next
End Sub
End Module
' The example displays the following output:
' Bad Format: 3351d3f0006747089ff928b5179b2051
' Bad Format: 3351d3f0-0067-4708-9ff9-28b5179b2051
' Successfully parsed {3351d3f0-0067-4708-9ff9-28b5179b2051}
' Bad Format: (3351d3f0-0067-4708-9ff9-28b5179b2051)
' Bad Format: {0x3351d3f0,0x0067,0x4708,{0x9f,0xf9,0x28,0xb5,0x17,0x9b,0x20,0x51}}
Uwagi
Metoda ParseExact 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 znaków odstępu. 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 szesnastkowe: 00000000000000000000000000000000 |
D | 32 cyfry szesnastkowe rozdzielone łącznikami: 00000000-0000-0000-0000-000000000000 |
B | 32 cyfry szesnastkowe oddzielone łącznikami, ujęte w nawiasy klamrowe: {00000000-0000-0000-0000-000000000000} |
P | 32 cyfry szesnastkowe rozdzielone łącznikami, ujęte w nawiasy: (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}} |