Guid.Parse Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Overload

Parse(String, IFormatProvider)	Mengurai string menjadi nilai.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Mengurai rentang karakter menjadi nilai.
Parse(String)	Mengonversi representasi string GUID ke struktur Guid yang setara.
Parse(ReadOnlySpan<Char>)	Mengonversi rentang karakter baca-saja yang mewakili GUID ke struktur Guid yang setara.

Parse(String, IFormatProvider)

Sumber:

Guid.cs

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

Guid

Hasil penguraian s.

Penerapan

Parse(String, IFormatProvider)

Parse(ReadOnlySpan<Char>, IFormatProvider)

Sumber:

Guid.cs

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 untuk diurai.

provider

IFormatProvider

Objek yang menyediakan informasi pemformatan khusus budaya tentang s.

Mengembalikan

Guid

Hasil penguraian s.

Penerapan

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(String)

Sumber:

Guid.cs

Mengonversi representasi string GUID ke struktur Guid yang setara.

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

Guid

Struktur yang berisi nilai yang diurai.

Pengecualian

ArgumentNullException

input null.

FormatException

input tidak dalam format yang dikenali.

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 Parse untuk mengonversi string kembali ke nilai Guid.

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 Parse memangkas spasi putih di awal atau akhir dari input dan mengonversi representasi string GUID menjadi nilai Guid. Metode ini dapat mengonversi string dalam salah satu dari lima format yang dihasilkan oleh metode ToString(String) 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 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}}

Metode ini 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 metode ToString dan tercantum dalam tabel sebelumnya.

Gunakan metode TryParse untuk menangkap operasi penguraian yang gagal tanpa harus menangani pengecualian.

Lihat juga

• TryParse(String, Guid)
• ToString()

Parse(ReadOnlySpan<Char>)

Sumber:

Guid.cs

Mengonversi rentang karakter baca-saja yang mewakili GUID ke struktur Guid yang setara.

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

Guid

Struktur yang berisi nilai yang diurai.

Pengecualian

FormatException

input tidak dalam format yang dikenali.

-atau-

Setelah pemangkasan, panjang rentang karakter baca-saja adalah 0.

Keterangan

Metode Parse memangkas karakter spasi putih awal atau akhir dari input dan mengonversi karakter yang tersisa dalam input menjadi nilai Guid. Metode ini dapat mengonversi rentang karakter yang mewakili salah satu dari lima format yang dihasilkan oleh metode ToString, 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 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}}

Metode ini 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 metode ToString dan tercantum dalam tabel sebelumnya.

Gunakan metode TryParse untuk menangkap operasi penguraian yang gagal tanpa harus menangani pengecualian.