Guid.Parse Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
Parse(String, IFormatProvider) |
Parsuje řetězec do hodnoty. |
Parse(ReadOnlySpan<Char>, IFormatProvider) |
Parsuje rozsah znaků do hodnoty. |
Parse(String) |
Převede řetězcovou reprezentaci identifikátoru GUID na ekvivalentní Guid strukturu. |
Parse(ReadOnlySpan<Char>) |
Převede rozsah znaků jen pro čtení, který představuje identifikátor GUID, na ekvivalentní strukturu Guid. |
Parse(String, IFormatProvider)
- Zdroj:
- Guid.cs
- Zdroj:
- Guid.cs
- 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 formátování specifické pro jazykovou verzi o s
.
Návraty
Výsledek analýzy s
.
Implementuje
Platí pro
Parse(ReadOnlySpan<Char>, IFormatProvider)
- Zdroj:
- Guid.cs
- Zdroj:
- Guid.cs
- 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 formátování specifické pro jazykovou verzi o s
.
Návraty
Výsledek analýzy s
.
Implementuje
Platí pro
Parse(String)
- Zdroj:
- Guid.cs
- Zdroj:
- Guid.cs
- 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
Struktura, která obsahuje hodnotu, která byla analyzována.
Výjimky
input
je null
.
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) metoda se specifikátory formátu "B", "D" a "X" a potom zavolá 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 z input
a převede řetězcovou reprezentaci identifikátoru GUID na hodnotu Guid. Tato metoda může převést řetězce v libovolném z pěti formátů vytvořených ToString(String) a ToString(String, IFormatProvider) metody, jak je znázorněno v následující tabulce.
Specifikátor | Popis | 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, pokud nemůže úspěšně parsovat ř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
má příliš mnoho nebo příliš málo znaků.input
není v jednom z formátů rozpoznaných metodou ToString a uvedená v předchozí tabulce.
Pomocí metody TryParse zachyťte neúspěšné operace analýzy, aniž byste museli zpracovat výjimku.
Viz také
Platí pro
Parse(ReadOnlySpan<Char>)
- Zdroj:
- Guid.cs
- Zdroj:
- Guid.cs
- Zdroj:
- Guid.cs
Převede rozsah znaků jen pro čtení, který představuje identifikátor GUID, na ekvivalentní strukturu 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
Parametry
- input
- ReadOnlySpan<Char>
Rozsah jen pro čtení obsahující bajty představující identifikátor GUID.
Návraty
Struktura, která obsahuje hodnotu, která byla analyzována.
Výjimky
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 v input
na hodnotu Guid. 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 | Popis | 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, pokud nemůže úspěšně parsovat ř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
má příliš mnoho nebo příliš málo znaků.input
není v jednom z formátů rozpoznaných metodou ToString a uvedená v předchozí tabulce.
Pomocí metody TryParse zachyťte neúspěšné operace analýzy, aniž byste museli zpracovat výjimku.