Guid.TryParse Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Přetížení

TryParse(ReadOnlySpan<Char>, Guid)	Převede zadaný rozsah znaků, které obsahují reprezentaci identifikátoru GUID, na ekvivalentní strukturu Guid.
TryParse(String, Guid)	Převede řetězcovou reprezentaci identifikátoru GUID na ekvivalentní Guid strukturu.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	Pokusí se analyzovat rozsah znaků do hodnoty.
TryParse(String, IFormatProvider, Guid)	Pokusí se analyzovat řetězec do hodnoty.

TryParse(ReadOnlySpan<Char>, Guid)

Zdroj:

Guid.cs

Převede zadaný rozsah znaků, které obsahují reprezentaci identifikátoru GUID, na ekvivalentní strukturu Guid.

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

Parametry

input

ReadOnlySpan<Char>

Rozsah obsahující znaky představující identifikátor GUID, který chcete převést.

result

Guid

Když tato metoda vrátí, obsahuje parsovanou hodnotu. Pokud metoda vrátí true, result obsahuje platný Guid. Pokud metoda vrátí false, result se rovná Empty.

Návraty

Boolean

true, pokud byla operace analýzy úspěšná; jinak false.

TryParse(String, Guid)

Zdroj:

Guid.cs

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

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::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

Parametry

input

String

Řetězec obsahující identifikátor GUID, který chcete převést.

result

Guid

Když tato metoda vrátí, obsahuje parsovanou hodnotu. Pokud metoda vrátí true, result obsahuje platný Guid. Pokud metoda vrátí false, result se rovná Empty.

Návraty

Boolean

true, pokud byla operace analýzy úspěšná; jinak false.

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) metoda se specifikátory formátu "B", "D" a "X" a potom zavolá metodu TryParse, která převede řetězce zpět na Guid hodnoty.

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

Poznámky

Tato metoda se podobá metodě Parse s tím rozdílem, že místo vrácení analyzovaného identifikátoru GUID vrátí false, pokud input je null nebo není v rozpoznaném formátu a nevyvolá výjimku. Oříznou všechny počáteční nebo koncové prázdné znaky z input a převede řetězce v libovolném z pěti formátů rozpoznaných metodami ToString(String) a ToString(String, IFormatProvider), jak je znázorněno v následující tabulce.

Specifikátor	Popis	Formát
N	32 číslic	00000000000000000000000000000000
D	32 číslic oddělených pomlčkami	00000000-0000-0000-0000-000000000000
B	32 číslic oddělených pomlčkami, uzavřených ve složených závorkách	{00000000-0000-0000-0000-000000000000}
P	32 číslic oddělených pomlčkami, 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}}

Viz také

• Parse(String)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Zdroj:

Guid.cs

Pokusí se analyzovat rozsah znaků do hodnoty.

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

Parametry

s

ReadOnlySpan<Char>

Rozsah znaků, které se mají analyzovat.

provider

IFormatProvider

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

result

Guid

Pokud tato metoda vrátí, obsahuje výsledek úspěšné analýzy s, nebo nedefinovanou hodnotu při selhání.

Návraty

Boolean

true, pokud se s úspěšně parsoval; jinak false.

TryParse(String, IFormatProvider, Guid)

Zdroj:

Guid.cs

Pokusí se analyzovat řetězec do hodnoty.

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

Parametry

s

String

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

provider

IFormatProvider

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

result

Guid

Pokud tato metoda vrátí, obsahuje výsledek úspěšné analýzy s nebo nedefinovanou hodnotu při selhání.

Návraty

Boolean

true, pokud se s úspěšně parsoval; jinak false.