Guid.Parse Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
Parse(String, IFormatProvider)	Parsuje řetězec do hodnoty.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Parsuje rozsah znaků do hodnoty.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Parsuje rozsah znaků UTF-8 do hodnoty.
Parse(ReadOnlySpan<Char>)	Převede rozsah znaků jen pro čtení, který představuje identifikátor GUID na ekvivalentní Guid strukturu.
Parse(ReadOnlySpan<Byte>)
Parse(String)	Převede řetězcovou reprezentaci identifikátoru GUID na ekvivalentní Guid strukturu.

Parse(String, IFormatProvider)

Zdroj:

Guid.cs

Parsuje řetězec do hodnoty.

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

Parametry

s

String

Řetězec, který se má analyzovat.

provider

IFormatProvider

Objekt, který poskytuje informace o sformátování specifické pro jazykovou verzi .

Návraty

Guid

Výsledek analýzy s.

Implementuje

Parse(String, IFormatProvider)

Parse(ReadOnlySpan<Char>, IFormatProvider)

Zdroj:

Guid.cs

Parsuje rozsah znaků do hodnoty.

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

Parametry

s

ReadOnlySpan<Char>

Rozsah znaků, které se mají analyzovat.

provider

IFormatProvider

Objekt, který poskytuje informace o sformátování specifické pro jazykovou verzi .

Návraty

Guid

Výsledek analýzy s.

Implementuje

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Zdroj:

Guid.cs

Parsuje rozsah znaků UTF-8 do hodnoty.

public:
 static Guid Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<Guid>::Parse;

public static Guid Parse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);

static member Parse : ReadOnlySpan<byte> * IFormatProvider -> Guid

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As Guid

Parametry

utf8Text

ReadOnlySpan<Byte>

Rozsah znaků UTF-8 pro analýzu.

provider

IFormatProvider

Objekt, který poskytuje informace o utf8Textformátování specifické pro jazykovou verzi .

Návraty

Guid

Výsledek analýzy utf8Text.

Implementuje

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Parse(ReadOnlySpan<Char>)

Zdroj:

Guid.cs

Převede rozsah znaků jen pro čtení, který představuje identifikátor GUID na ekvivalentní Guid strukturu.

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

Parametry

input

ReadOnlySpan<Char>

Rozsah jen pro čtení obsahující bajty představující identifikátor GUID.

Návraty

Guid

Struktura, která obsahuje hodnotu, která byla analyzována.

Výjimky

FormatException

input není v rozpoznaném formátu.

nebo

Po oříznutí je délka rozsahu znaků jen pro čtení 0.

Poznámky

Metoda Parse oříznou všechny počáteční nebo koncové prázdné znaky z input a převede zbývající znaky input na Guid hodnotu. Tato metoda může převést rozsah znaků, který představuje některý z pěti formátů vytvořených metodami ToString , jak je znázorněno v následující tabulce.

Specifikátor	Description	Formát
N	32 šestnáctkových číslic	00000000000000000000000000000000
D	32 šestnáctkových číslic oddělených spojovníky	00000000-0000-0000-0000-000000000000
B	32 šestnáctkových číslic oddělených spojovníky, uzavřených ve složených závorkách	{00000000-0000-0000-0000-000000000000}
P	32 šestnáctkových číslic oddělených spojovníky, uzavřených v závorkách	(00000000-0000-0000-0000-000000000000)
X	Čtyři šestnáctkové hodnoty uzavřené ve složených závorkách, kde čtvrtá hodnota je podmnožinou osmi šestnáctkových hodnot, které jsou také uzavřeny ve složených závorkách.	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Metoda vyvolá FormatException chybu, pokud nelze úspěšně analyzovat řetězec. Mezi důvody, proč k tomu může dojít, patří:

• input obsahuje znaky, které nejsou součástí šestnáctkové znakové sady.

• input obsahuje příliš mnoho nebo příliš málo znaků.

• input není v jednom z formátů rozpoznaných metodou ToString a uvedených v předchozí tabulce.

Použijte metodu TryParse k zachycení neúspěšných operací analýzy, aniž byste museli zpracovat výjimku.

Parse(ReadOnlySpan<Byte>)

Zdroj:

Guid.cs

public:
 static Guid Parse(ReadOnlySpan<System::Byte> utf8Text);

public static Guid Parse(ReadOnlySpan<byte> utf8Text);

static member Parse : ReadOnlySpan<byte> -> Guid

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As Guid

Parametry

utf8Text

ReadOnlySpan<Byte>

Návraty

Guid

Parse(String)

Zdroj:

Guid.cs

Převede řetězcovou reprezentaci identifikátoru GUID na ekvivalentní Guid strukturu.

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

Parametry

input

String

Řetězec, který chcete převést.

Návraty

Guid

Struktura, která obsahuje hodnotu, která byla analyzována.

Výjimky

ArgumentNullException

input je null.

FormatException

input není v rozpoznaném formátu.

Příklady

Následující příklad vytvoří nový identifikátor GUID, převede ho na tři samostatné řetězcové reprezentace voláním ToString(String) metody se specifikátory formátu "B", "D" a "X" a pak volá metodu Parse , která převede řetězce zpět na Guid hodnoty.

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

Poznámky

Metoda Parse oříznou všechny počáteční nebo koncové prázdné znaky a input převede řetězcovou reprezentaci identifikátoru GUID na Guid hodnotu. Tato metoda může převést řetězce v libovolném z pěti formátů vytvořených metodami ToString(String) , ToString(String, IFormatProvider) jak je znázorněno v následující tabulce.

Specifikátor	Description	Formát
N	32 šestnáctkových číslic	00000000000000000000000000000000
D	32 šestnáctkových číslic oddělených spojovníky	00000000-0000-0000-0000-000000000000
B	32 šestnáctkových číslic oddělených spojovníky, uzavřených ve složených závorkách	{00000000-0000-0000-0000-000000000000}
P	32 šestnáctkových číslic oddělených spojovníky, uzavřených v závorkách	(00000000-0000-0000-0000-000000000000)
X	Čtyři šestnáctkové hodnoty uzavřené ve složených závorkách, kde čtvrtá hodnota je podmnožinou osmi šestnáctkových hodnot, které jsou také uzavřeny ve složených závorkách.	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Metoda vyvolá FormatException chybu, pokud nelze úspěšně analyzovat řetězec. Mezi důvody, proč k tomu může dojít, patří:

• input obsahuje znaky, které nejsou součástí šestnáctkové znakové sady.

• input obsahuje příliš mnoho nebo příliš málo znaků.

• input není v jednom z formátů rozpoznaných metodou ToString a uvedených v předchozí tabulce.

Použijte metodu TryParse k zachycení neúspěšných operací analýzy, aniž byste museli zpracovat výjimku.

Viz také

• TryParse(String, Guid)
• ToString()