Guid.TryParse Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
TryParse(ReadOnlySpan<Char>, Guid) |
Mengonversi rentang karakter baca-saja yang ditentukan yang berisi representasi GUID ke struktur Guid yang setara. |
TryParse(String, Guid) |
Mengonversi representasi string GUID ke struktur Guid yang setara. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid) |
Mencoba mengurai rentang karakter menjadi nilai. |
TryParse(String, IFormatProvider, Guid) |
Mencoba mengurai string ke dalam nilai. |
TryParse(ReadOnlySpan<Char>, Guid)
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
Mengonversi rentang karakter baca-saja yang ditentukan yang berisi representasi GUID ke struktur Guid yang setara.
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>
Rentang yang berisi karakter yang mewakili GUID untuk dikonversi.
- result
- Guid
Ketika metode ini kembali, berisi nilai yang diurai. Jika metode mengembalikan true
, result
berisi Guidyang valid. Jika metode mengembalikan false
, result
sama dengan Empty.
Mengembalikan
true
jika operasi penguraian berhasil; jika tidak, false
.
Berlaku untuk
TryParse(String, Guid)
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
Mengonversi representasi string GUID ke struktur Guid yang setara.
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
String yang berisi GUID untuk dikonversi.
- result
- Guid
Ketika metode ini kembali, berisi nilai yang diurai. Jika metode mengembalikan true
, result
berisi Guidyang valid. Jika metode mengembalikan false
, result
sama dengan Empty.
Mengembalikan
true
jika operasi penguraian berhasil; jika tidak, false
.
Contoh
Contoh berikut membuat GUID baru, mengonversinya menjadi tiga representasi string terpisah dengan memanggil metode ToString(String) dengan penentu format "B", "D", dan "X", lalu memanggil metode TryParse untuk mengonversi string kembali ke nilai Guid.
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
Keterangan
Metode ini seperti metode Parse, kecuali bahwa alih-alih mengembalikan GUID yang diurai, metode ini mengembalikan false
jika input
null
atau tidak dalam format yang dikenali, dan tidak memberikan pengecualian. Ini memangkas spasi putih di depan atau di belakang dari input
dan mengonversi string dalam salah satu dari lima format yang dikenali oleh metode ToString(String) dan ToString(String, IFormatProvider), seperti yang ditunjukkan dalam tabel berikut.
Penentu | Deskripsi | Format |
---|---|---|
N |
32 digit | 00000000000000000000000000000000 |
D |
32 digit dipisahkan oleh tanda hubung | 00000000-0000-0000-0000-000000000000 |
B |
32 digit dipisahkan oleh tanda hubung, diapit kurung kurawal | {00000000-0000-0000-0000-000000000000} |
P |
32 digit dipisahkan oleh tanda hubung, diapit tanda kurung | (00000000-0000-0000-0000-000000000000) |
X |
Empat nilai heksadesimal diapit dalam kurung kurawal, di mana nilai keempat adalah subset dari delapan nilai heksadesimal yang juga diapit kurung kurawal | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
Lihat juga
Berlaku untuk
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
Mencoba mengurai rentang karakter menjadi nilai.
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>
Rentang karakter untuk diurai.
- provider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang s
.
- result
- Guid
Ketika metode ini kembali, berisi hasil penguraian yang berhasil s
, atau nilai yang tidak ditentukan pada kegagalan.
Mengembalikan
true
jika s
berhasil diurai; jika tidak, false
.
Berlaku untuk
TryParse(String, IFormatProvider, Guid)
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
- Sumber:
- Guid.cs
Mencoba mengurai string ke dalam nilai.
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
String yang akan diurai.
- provider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang s
.
- result
- Guid
Ketika metode ini kembali, berisi hasil dari penguraian s
yang berhasil atau nilai yang tidak terdefinisi pada kegagalan.
Mengembalikan
true
jika s
berhasil diurai; jika tidak, false
.