Guid.Parse Methode

Definitie

Naamruimte:: System

Assembly's:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Overloads

Name	Description
Parse(String, IFormatProvider)	Parseert een tekenreeks in een waarde.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Parseert een reeks tekens in een waarde.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Parseert een reeks UTF-8 tekens in een waarde.
Parse(ReadOnlySpan<Char>)	Converteert een alleen-lezen tekenbereik dat een GUID vertegenwoordigt naar de equivalente Guid structuur.
Parse(ReadOnlySpan<Byte>)
Parse(String)	Converteert de tekenreeksweergave van een GUID naar de equivalente Guid structuur.

Parse(String, IFormatProvider)

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Parseert een tekenreeks in een waarde.

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

Parameters

s: String

De tekenreeks die moet worden geparseerd.

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie biedt over s.

Retouren

Guid

Het resultaat van parseren s.

Implementeringen

Parse(String, IFormatProvider)

Van toepassing op

Parse(ReadOnlySpan<Char>, IFormatProvider)

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Parseert een reeks tekens in een waarde.

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

Parameters

s: ReadOnlySpan<Char>

De reeks tekens die moeten worden geparseerd.

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie biedt over s.

Retouren

Guid

Het resultaat van parseren s.

Implementeringen

Parse(ReadOnlySpan<Char>, IFormatProvider)

Van toepassing op

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Bron:: Guid.cs

Bron:: Guid.cs

Parseert een reeks UTF-8 tekens in een waarde.

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

Parameters

utf8Text: ReadOnlySpan<Byte>

Het bereik van UTF-8 tekens om te parseren.

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie biedt over utf8Text.

Retouren

Guid

Het resultaat van parseren utf8Text.

Implementeringen

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Van toepassing op

Parse(ReadOnlySpan<Char>)

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Converteert een alleen-lezen tekenbereik dat een GUID vertegenwoordigt naar de equivalente Guid structuur.

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

Parameters

input: ReadOnlySpan<Char>

Een alleen-lezenspanne met de bytes die een GUID vertegenwoordigen.

Retouren

Guid

Een structuur die de waarde bevat die is geparseerd.

Uitzonderingen

FormatException

input heeft geen herkende indeling.

– of –

Na het bijsnijden is de lengte van het tekenbereik alleen-lezen 0.

Opmerkingen

Met Parse de methode worden voorloop- of volgspaties van eventuele voorloop- of volgspaties input verwijderd en worden de resterende tekens geconverteerd input naar een Guid waarde. Met deze methode kunt u een tekenbereik converteren dat een van de vijf indelingen vertegenwoordigt die door de ToString methoden worden geproduceerd, zoals wordt weergegeven in de volgende tabel.

Specificator	Beschrijving	Format
`N`	32 hexadecimale cijfers	00000000000000000000000000000000
`D`	32 hexadecimale cijfers gescheiden door afbreekstreepjes	00000000-0000-0000-0000-000000000000
`B`	32 hexadecimale cijfers gescheiden door afbreekstreepjes, tussen accolades	{00000000-0000-0000-0000-000000000000}
`P`	32 hexadecimale cijfers gescheiden door afbreekstreepjes, tussen haakjes	(00000000-0000-0000-0000-000000000000)
`X`	Vier hexadecimale waarden tussen accolades, waarbij de vierde waarde een subset is van acht hexadecimale waarden die ook tussen accolades zijn opgenomen	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

De methode genereert een FormatException als de tekenreeks niet kan worden geparseerd. Enkele van de redenen waarom dit kan gebeuren, zijn:

input bevat tekens die geen deel uitmaken van de hexadecimale tekenset.
input heeft te veel of te weinig tekens.
input bevindt zich niet in een van de indelingen die worden herkend door de ToString methode en wordt vermeld in de vorige tabel.

Gebruik de TryParse methode om mislukte parseringsbewerkingen te ondervangen zonder dat u een uitzondering hoeft te verwerken.

Van toepassing op

Parse(ReadOnlySpan<Byte>)

Bron:: Guid.cs

Bron:: 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

Parameters

utf8Text: ReadOnlySpan<Byte>

Retouren

Guid

Van toepassing op

Parse(String)

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Converteert de tekenreeksweergave van een GUID naar de equivalente Guid structuur.

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

Parameters

input: String

De tekenreeks die moet worden geconverteerd.

Retouren

Guid

Een structuur die de waarde bevat die is geparseerd.

Uitzonderingen

ArgumentNullException

input is null.

FormatException

input heeft geen herkende indeling.

Voorbeelden

In het volgende voorbeeld wordt een nieuwe GUID gemaakt, geconverteerd naar drie afzonderlijke tekenreeksweergaven door de ToString(String) methode aan te roepen met de notatieaanduidingen B, D en X, en wordt de Parse methode vervolgens aangeroepen om de tekenreeksen weer te converteren naar Guid waarden.

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

Opmerkingen

Met Parse de methode wordt een voorloop- of volgspaties verwijderd van input en wordt de tekenreeksweergave van een GUID geconverteerd naar een Guid waarde. Met deze methode kunnen tekenreeksen worden geconverteerd in een van de vijf indelingen die door de ToString(String) en ToString(String, IFormatProvider) methoden worden geproduceerd, zoals wordt weergegeven in de volgende tabel.

Specificator	Beschrijving	Format
`N`	32 hexadecimale cijfers	00000000000000000000000000000000
`D`	32 hexadecimale cijfers gescheiden door afbreekstreepjes	00000000-0000-0000-0000-000000000000
`B`	32 hexadecimale cijfers gescheiden door afbreekstreepjes, tussen accolades	{00000000-0000-0000-0000-000000000000}
`P`	32 hexadecimale cijfers gescheiden door afbreekstreepjes, tussen haakjes	(00000000-0000-0000-0000-000000000000)
`X`	Vier hexadecimale waarden tussen accolades, waarbij de vierde waarde een subset is van acht hexadecimale waarden die ook tussen accolades zijn opgenomen	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

De methode genereert een FormatException als de tekenreeks niet kan worden geparseerd. Enkele van de redenen waarom dit kan gebeuren, zijn:

input bevat tekens die geen deel uitmaken van de hexadecimale tekenset.
input heeft te veel of te weinig tekens.
input bevindt zich niet in een van de indelingen die worden herkend door de ToString methode en wordt vermeld in de vorige tabel.

Gebruik de TryParse methode om mislukte parseringsbewerkingen te ondervangen zonder dat u een uitzondering hoeft te verwerken.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?