Guid.Parse Metod

Definition

Namnområde:: System

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: netstandard.dll

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättning:: mscorlib.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Överlagringar

Name	Description
Parse(String, IFormatProvider)	Parsar en sträng till ett värde.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Parsar ett teckenintervall till ett värde.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Parsar ett intervall med UTF-8 tecken till ett värde.
Parse(ReadOnlySpan<Char>)	Konverterar ett skrivskyddat teckenintervall som representerar ett GUID till motsvarande Guid struktur.
Parse(ReadOnlySpan<Byte>)
Parse(String)	Konverterar strängrepresentationen av ett GUID till motsvarande Guid struktur.

Parse(String, IFormatProvider)

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Parsar en sträng till ett värde.

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

Parametrar

s: String

Strängen som ska parsas.

provider: IFormatProvider

Ett objekt som tillhandahåller kulturspecifik formateringsinformation om s.

Returer

Guid

Resultatet av parsning s.

Implementeringar

Parse(String, IFormatProvider)

Gäller för

Parse(ReadOnlySpan<Char>, IFormatProvider)

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Parsar ett teckenintervall till ett värde.

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

Parametrar

s: ReadOnlySpan<Char>

Det intervall med tecken som ska parsas.

provider: IFormatProvider

Ett objekt som tillhandahåller kulturspecifik formateringsinformation om s.

Returer

Guid

Resultatet av parsning s.

Implementeringar

Parse(ReadOnlySpan<Char>, IFormatProvider)

Gäller för

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Källa:: Guid.cs

Källa:: Guid.cs

Parsar ett intervall med UTF-8 tecken till ett värde.

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

Parametrar

utf8Text: ReadOnlySpan<Byte>

Intervallet för UTF-8 tecken att parsa.

provider: IFormatProvider

Ett objekt som tillhandahåller kulturspecifik formateringsinformation om utf8Text.

Returer

Guid

Resultatet av parsning utf8Text.

Implementeringar

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Gäller för

Parse(ReadOnlySpan<Char>)

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Konverterar ett skrivskyddat teckenintervall som representerar ett GUID till motsvarande Guid struktur.

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

Parametrar

input: ReadOnlySpan<Char>

Ett skrivskyddat intervall som innehåller byte som representerar ett GUID.

Returer

Guid

En struktur som innehåller värdet som parsades.

Undantag

FormatException

input är inte i ett igenkänt format.

-eller-

Efter trimning är längden på det skrivskyddade teckenintervallet 0.

Kommentarer

Metoden Parse trimmar alla inledande eller avslutande blankstegstecken från input och konverterar de återstående tecknen till input ett Guid värde. Den här metoden kan konvertera ett teckenintervall som representerar något av de fem format som skapas av ToString metoderna, enligt följande tabell.

Specificerare	Description	Format
`N`	32 hexadecimala siffror	00000000000000000000000000000000
`D`	32 hexadecimala siffror avgränsade med bindestreck	00000000-0000-0000-0000-000000000000
`B`	32 hexadecimala siffror avgränsade med bindestreck, omgivna i klammerparenteser	{00000000-0000-0000-0000-000000000000}
`P`	32 hexadecimala siffror avgränsade med bindestreck, omgivna i parenteser	(00000000-0000-0000-0000-000000000000)
`X`	Fyra hexadecimala värden omgivna av klammerparenteser, där det fjärde värdet är en delmängd av åtta hexadecimala värden som också omges av klammerparenteser	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Metoden genererar en FormatException om den inte kan parsa strängen. Några av orsakerna till varför detta kan inträffa är:

input innehåller tecken som inte ingår i den hexadecimala teckenuppsättningen.
input har för många eller för få tecken.
input är inte i något av de format som identifieras av ToString metoden och anges i föregående tabell.

TryParse Använd metoden för att fånga upp misslyckade parsningsåtgärder utan att behöva hantera ett undantag.

Gäller för

Parse(ReadOnlySpan<Byte>)

Källa:: Guid.cs

Källa:: 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

Parametrar

utf8Text: ReadOnlySpan<Byte>

Returer

Guid

Gäller för

Parse(String)

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Konverterar strängrepresentationen av ett GUID till motsvarande Guid struktur.

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

Parametrar

input: String

Sträng som ska konverteras.

Returer

Guid

En struktur som innehåller värdet som parsades.

Undantag

ArgumentNullException

input är null.

FormatException

input är inte i ett igenkänt format.

Exempel

I följande exempel skapas ett nytt GUID, konverterar det till tre separata strängrepresentationer genom att anropa ToString(String) metoden med formatspecificerarna "B", "D" och "X" och anropar Parse sedan metoden för att konvertera strängarna tillbaka till Guid värden.

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

Kommentarer

Metoden Parse trimmar alla inledande eller avslutande blanksteg från input och konverterar strängrepresentationen av ett GUID till ett Guid värde. Den här metoden kan konvertera strängar i något av de fem format som skapas av ToString(String) metoderna och ToString(String, IFormatProvider) , som du ser i följande tabell.

Specificerare	Description	Format
`N`	32 hexadecimala siffror	00000000000000000000000000000000
`D`	32 hexadecimala siffror avgränsade med bindestreck	00000000-0000-0000-0000-000000000000
`B`	32 hexadecimala siffror avgränsade med bindestreck, omgivna i klammerparenteser	{00000000-0000-0000-0000-000000000000}
`P`	32 hexadecimala siffror avgränsade med bindestreck, omgivna i parenteser	(00000000-0000-0000-0000-000000000000)
`X`	Fyra hexadecimala värden omgivna av klammerparenteser, där det fjärde värdet är en delmängd av åtta hexadecimala värden som också omges av klammerparenteser	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Metoden genererar en FormatException om den inte kan parsa strängen. Några av orsakerna till varför detta kan inträffa är:

input innehåller tecken som inte ingår i den hexadecimala teckenuppsättningen.
input har för många eller för få tecken.
input är inte i något av de format som identifieras av ToString metoden och anges i föregående tabell.

TryParse Använd metoden för att fånga upp misslyckade parsningsåtgärder utan att behöva hantera ett undantag.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?