Guid.Parse Metodo

Definizione

Spazio dei nomi:: System

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

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

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

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

Nome	Descrizione
Parse(String, IFormatProvider)	Analizza una stringa in un valore.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analizza un intervallo di caratteri in un valore.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Analizza un intervallo di caratteri UTF-8 in un valore.
Parse(ReadOnlySpan<Char>)	Converte un intervallo di caratteri di sola lettura che rappresenta un GUID nella struttura equivalente Guid .
Parse(ReadOnlySpan<Byte>)
Parse(String)	Converte la rappresentazione di stringa di un GUID nella struttura equivalente Guid .

Parse(String, IFormatProvider)

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Analizza una stringa in un valore.

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

Parametri

s: String

Stringa da analizzare.

provider: IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura su s.

Valori restituiti

Guid

Risultato dell'analisi sdi .

Implementazioni

Parse(String, IFormatProvider)

Si applica a

Parse(ReadOnlySpan<Char>, IFormatProvider)

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Analizza un intervallo di caratteri in un valore.

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

Parametri

s: ReadOnlySpan<Char>

Intervallo di caratteri da analizzare.

provider: IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura su s.

Valori restituiti

Guid

Risultato dell'analisi sdi .

Implementazioni

Parse(ReadOnlySpan<Char>, IFormatProvider)

Si applica a

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Origine:: Guid.cs

Origine:: Guid.cs

Analizza un intervallo di caratteri UTF-8 in un valore.

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

Parametri

utf8Text: ReadOnlySpan<Byte>

Intervallo di caratteri UTF-8 da analizzare.

provider: IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura su utf8Text.

Valori restituiti

Guid

Risultato dell'analisi utf8Textdi .

Implementazioni

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Si applica a

Parse(ReadOnlySpan<Char>)

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Converte un intervallo di caratteri di sola lettura che rappresenta un GUID nella struttura equivalente 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

Parametri

input: ReadOnlySpan<Char>

Intervallo di sola lettura contenente i byte che rappresentano un GUID.

Valori restituiti

Guid

Struttura che contiene il valore analizzato.

Eccezioni

FormatException

input non è in un formato riconosciuto.

oppure

Dopo il taglio, la lunghezza dell'intervallo di caratteri di sola lettura è 0.

Commenti

Il Parse metodo taglia tutti gli spazi vuoti iniziali o finali da input e converte i caratteri rimanenti in input un Guid valore. Questo metodo può convertire un intervallo di caratteri che rappresenta uno dei cinque formati prodotti dai ToString metodi , come illustrato nella tabella seguente.

Identificatore	Description	Formato
`N`	32 cifre esadecimali	00000000000000000000000000000000
`D`	32 cifre esadecimali separate da trattini	00000000-0000-0000-0000-000000000000
`B`	32 cifre esadecimali separate da trattini, racchiuse tra parentesi graffe	{00000000-0000-0000-0000-000000000000}
`P`	32 cifre esadecimali separate da trattini, racchiuse tra parentesi	(00000000-0000-0000-0000-000000000000)
`X`	Quattro valori esadecimali racchiusi tra parentesi graffe, dove il quarto valore è un subset di otto valori esadecimali racchiusi tra parentesi graffe	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Il metodo genera un'eccezione FormatException se non è in grado di analizzare correttamente la stringa. Alcuni dei motivi per cui può verificarsi questo problema includono:

input contiene caratteri che non fanno parte del set di caratteri esadecimali.
input ha un numero eccessivo di caratteri o troppo pochi.
input non è in uno dei formati riconosciuti dal ToString metodo e elencati nella tabella precedente.

Usare il TryParse metodo per rilevare eventuali operazioni di analisi non riuscite senza dover gestire un'eccezione.

Si applica a

Parse(ReadOnlySpan<Byte>)

Origine:: Guid.cs

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

Parametri

utf8Text: ReadOnlySpan<Byte>

Valori restituiti

Guid

Si applica a

Parse(String)

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Origine:: Guid.cs

Converte la rappresentazione di stringa di un GUID nella struttura equivalente Guid .

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

Parametri

input: String

Stringa da convertire.

Valori restituiti

Guid

Struttura che contiene il valore analizzato.

Eccezioni

ArgumentNullException

input è null.

FormatException

input non è in un formato riconosciuto.

Esempio

L'esempio seguente crea un nuovo GUID, lo converte in tre rappresentazioni di stringa separate chiamando il ToString(String) metodo con gli identificatori di formato "B", "D" e "X" e quindi chiama il Parse metodo per convertire nuovamente le stringhe in Guid valori.

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

Commenti

Il Parse metodo taglia qualsiasi spazio vuoto iniziale o finale da input e converte la rappresentazione di stringa di un GUID in un Guid valore. Questo metodo può convertire le stringhe in uno dei cinque formati prodotti dai ToString(String) metodi e ToString(String, IFormatProvider) , come illustrato nella tabella seguente.

Identificatore	Description	Formato
`N`	32 cifre esadecimali	00000000000000000000000000000000
`D`	32 cifre esadecimali separate da trattini	00000000-0000-0000-0000-000000000000
`B`	32 cifre esadecimali separate da trattini, racchiuse tra parentesi graffe	{00000000-0000-0000-0000-000000000000}
`P`	32 cifre esadecimali separate da trattini, racchiuse tra parentesi	(00000000-0000-0000-0000-000000000000)
`X`	Quattro valori esadecimali racchiusi tra parentesi graffe, dove il quarto valore è un subset di otto valori esadecimali racchiusi tra parentesi graffe	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Il metodo genera un'eccezione FormatException se non è in grado di analizzare correttamente la stringa. Alcuni dei motivi per cui può verificarsi questo problema includono:

input contiene caratteri che non fanno parte del set di caratteri esadecimali.
input ha un numero eccessivo di caratteri o troppo pochi.
input non è in uno dei formati riconosciuti dal ToString metodo e elencati nella tabella precedente.

Usare il TryParse metodo per rilevare eventuali operazioni di analisi non riuscite senza dover gestire un'eccezione.

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?