Guid.Parse 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
Parse(String, IFormatProvider) |
Mengurai string menjadi nilai. |
Parse(ReadOnlySpan<Char>, IFormatProvider) |
Mengurai rentang karakter menjadi nilai. |
Parse(ReadOnlySpan<Char>) |
Mengonversi rentang karakter baca-saja yang mewakili GUID ke struktur yang setara Guid . |
Parse(String) |
Mengonversi representasi string GUID ke struktur yang setara Guid . |
Parse(String, IFormatProvider)
Mengurai string menjadi nilai.
public:
static Guid Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<Guid>::Parse;
public static Guid Parse (string s, IFormatProvider? provider);
static member Parse : string * IFormatProvider -> Guid
Public Shared Function Parse (s As String, provider As IFormatProvider) As Guid
Parameter
- s
- String
String yang akan diurai.
- provider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang s
.
Mengembalikan
Hasil penguraian s
.
Penerapan
Berlaku untuk
Parse(ReadOnlySpan<Char>, IFormatProvider)
Mengurai rentang karakter menjadi nilai.
public:
static Guid Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<Guid>::Parse;
public static Guid Parse (ReadOnlySpan<char> s, IFormatProvider? provider);
static member Parse : ReadOnlySpan<char> * IFormatProvider -> Guid
Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Guid
Parameter
- s
- ReadOnlySpan<Char>
Rentang karakter yang akan diurai.
- provider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang s
.
Mengembalikan
Hasil penguraian s
.
Penerapan
Berlaku untuk
Parse(ReadOnlySpan<Char>)
Mengonversi rentang karakter baca-saja yang mewakili GUID ke struktur yang setara Guid .
public:
static Guid Parse(ReadOnlySpan<char> input);
public static Guid Parse (ReadOnlySpan<char> input);
static member Parse : ReadOnlySpan<char> -> Guid
Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Guid
Parameter
- input
- ReadOnlySpan<Char>
Rentang baca-saja yang berisi byte yang mewakili GUID.
Mengembalikan
Struktur yang berisi nilai yang diurai.
Pengecualian
input
tidak dalam format yang dikenali.
-atau-
Setelah pemangkasan, panjang rentang karakter baca-saja adalah 0.
Keterangan
Metode memangkas Parse karakter spasi putih di awal atau akhir dari input
dan mengonversi karakter input
yang Guid tersisa menjadi nilai. Metode ini dapat mengonversi rentang karakter yang mewakili salah satu dari lima format yang dihasilkan oleh ToString metode , seperti yang ditunjukkan dalam tabel berikut.
Penentu | Deskripsi | Format |
---|---|---|
N |
32 digit heksadesimal | 00000000000000000000000000000000 |
D |
32 digit heksadesimal dipisahkan oleh tanda hubung | 00000000-0000-0000-0000-000000000000 |
B |
32 digit heksadesimal dipisahkan oleh tanda hubung, diapit kurung kurawal | {00000000-0000-0000-0000-000000000000} |
P |
32 digit heksadesimal dipisahkan oleh tanda hubung, diapit dalam tanda kurung | (00000000-0000-0000-0000-000000000000) |
X |
Empat nilai heksadesimal yang diapit dalam kurung kurawal, di mana nilai keempat adalah subset dari delapan nilai heksadesimal yang juga diapit dalam kurung kurawal | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
Metode melempar FormatException jika tidak berhasil mengurai string. Beberapa alasan mengapa hal ini mungkin terjadi meliputi:
input
berisi karakter yang bukan bagian dari set karakter heksadesimal.input
memiliki terlalu banyak atau terlalu sedikit karakter.input
tidak dalam salah satu format yang dikenali oleh ToString metode dan tercantum dalam tabel sebelumnya.
TryParse Gunakan metode untuk menangkap operasi penguraian yang gagal tanpa harus menangani pengecualian.
Berlaku untuk
Parse(String)
Mengonversi representasi string GUID ke struktur yang setara Guid .
public:
static Guid Parse(System::String ^ input);
public static Guid Parse (string input);
static member Parse : string -> Guid
Public Shared Function Parse (input As String) As Guid
Parameter
- input
- String
String yang akan dikonversi.
Mengembalikan
Struktur yang berisi nilai yang diurai.
Pengecualian
input
adalah null
.
input
tidak dalam format yang dikenali.
Contoh
Contoh berikut membuat GUID baru, mengonversinya menjadi tiga representasi string terpisah dengan memanggil ToString(String) metode dengan penentu format "B", "D", dan "X", lalu memanggil Parse metode untuk mengonversi string kembali ke Guid nilai.
var 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)
{
try
{
Guid newGuid = Guid.Parse(stringGuid);
Console.WriteLine($"Converted {stringGuid} to a Guid");
}
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:
//
// 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
try
let newGuid = Guid.Parse stringGuid
printfn $"Converted {stringGuid} to a Guid"
with
| :? ArgumentNullException ->
printfn "The string to be parsed is null."
| :? FormatException ->
printfn $"Bad format: {stringGuid}"
// 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.
For Each stringGuid In stringGuids
Try
Dim newGuid As Guid = Guid.Parse(stringGuid)
Console.WriteLine("Converted {0} to a Guid", 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:
' 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 memangkas Parse spasi input
putih di depan atau di belakang dan mengonversi representasi string GUID menjadi Guid nilai. Metode ini dapat mengonversi string dalam salah satu dari lima format yang dihasilkan oleh ToString(String) metode dan ToString(String, IFormatProvider) , seperti yang ditunjukkan dalam tabel berikut.
Penentu | Deskripsi | Format |
---|---|---|
N |
32 digit heksadesimal | 00000000000000000000000000000000 |
D |
32 digit heksadesimal dipisahkan oleh tanda hubung | 00000000-0000-0000-0000-000000000000 |
B |
32 digit heksadesimal dipisahkan oleh tanda hubung, diapit kurung kurawal | {00000000-0000-0000-0000-000000000000} |
P |
32 digit heksadesimal dipisahkan oleh tanda hubung, diapit dalam tanda kurung | (00000000-0000-0000-0000-000000000000) |
X |
Empat nilai heksadesimal yang diapit dalam kurung kurawal, di mana nilai keempat adalah subset dari delapan nilai heksadesimal yang juga diapit dalam kurung kurawal | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
Metode melempar FormatException jika tidak berhasil mengurai string. Beberapa alasan mengapa hal ini mungkin terjadi meliputi:
input
berisi karakter yang bukan bagian dari set karakter heksadesimal.input
memiliki terlalu banyak atau terlalu sedikit karakter.input
tidak dalam salah satu format yang dikenali oleh ToString metode dan tercantum dalam tabel sebelumnya.
TryParse Gunakan metode untuk menangkap operasi penguraian yang gagal tanpa harus menangani pengecualian.
Lihat juga
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk