Guid.Parse Metode

Definisi

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

inputadalah 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