Guid.Parse Método

Definición

Sobrecargas

Parse(String)

Convierte la representación de cadena de un identificador GUID en la estructura Guid equivalente.Converts the string representation of a GUID to the equivalent Guid structure.

Parse(ReadOnlySpan<Char>)

Convierte un intervalo de caracteres de solo lectura que representa un GUID en la estructura Guid equivalente.Converts a read-only character span that represents a GUID to the equivalent Guid structure.

Parse(String)

Convierte la representación de cadena de un identificador GUID en la estructura Guid equivalente.Converts the string representation of a GUID to the equivalent Guid structure.

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

Parámetros

input
String

Cadena que se va a convertir.The string to convert.

Devoluciones

Guid

Estructura que contiene el valor que se analizó.A structure that contains the value that was parsed.

Excepciones

input es null.input is null.

input no es un formato reconocido.input is not in a recognized format.

Ejemplos

En el ejemplo siguiente se crea un nuevo GUID, que lo convierte en tres representaciones de cadena independientes llamando al ToString(String) método con los especificadores de formato "B", "D" y "X" y, a continuación, llama al Parse método para volver a convertir las cadenas en Guid valores.The following example creates a new GUID, converts it to three separate string representations by calling the ToString(String) method with the "B", "D", and "X" format specifiers, and then calls the Parse method to convert the strings back to Guid values.

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

Comentarios

El Parse método recorta los espacios en blanco iniciales o finales de input y convierte la representación de cadena de un GUID en un Guid valor.The Parse method trims any leading or trailing white space from input and converts the string representation of a GUID to a Guid value. Este método puede convertir cadenas en cualquiera de los cinco formatos generados por ToString(String) los ToString(String, IFormatProvider) métodos y, como se muestra en la tabla siguiente.This method can convert strings in any of the five formats produced by the ToString(String) and ToString(String, IFormatProvider) methods, as shown in the following table.

EspecificadorSpecifier DescripciónDescription FormatoFormat
N 32 dígitos32 digits 0000000000000000000000000000000000000000000000000000000000000000
D 32 dígitos separados por guiones32 digits separated by hyphens 00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 dígitos separados por guiones, entre llaves32 digits separated by hyphens, enclosed in braces {00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por guiones, entre paréntesis32 digits separated by hyphens, enclosed in parentheses (00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X Cuatro valores hexadecimales entre llaves, donde el cuarto valor es un subconjunto de ocho valores hexadecimales que también se incluye entre llavesFour hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

El método produce una excepción FormatException si no puede analizar correctamente la cadena.The method throws a FormatException if it is unable to successfully parse the string. Estas son algunas de las razones por las que esto puede ocurrir:Here are some of the reasons why this might occur include:

  • input contiene caracteres que no forman parte del juego de caracteres hexadecimales.input contains characters that are not part of the hexadecimal character set.

  • input tiene demasiados caracteres numéricos o demasiado pocos.input has too many or too few numeric characters.

  • input tiene demasiados o pocos caracteres no numéricos adecuados para un formato determinado.input has too many or too few of the non-numeric characters appropriate for a particular format.

  • input no se encuentra en uno de los formatos reconocidos por el ToString método y que se enumeran en la tabla anterior.input is not in one of the formats recognized by the ToString method and listed in the previous table.

Use el TryParse método para detectar cualquier operación de análisis incorrecta sin tener que controlar una excepción.Use the TryParse method to catch any unsuccessful parse operations without having to handle an exception.

Consulte también

Se aplica a

Parse(ReadOnlySpan<Char>)

Convierte un intervalo de caracteres de solo lectura que representa un GUID en la estructura Guid equivalente.Converts a read-only character span that represents a GUID to the equivalent Guid structure.

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

Parámetros

input
ReadOnlySpan<Char>

Intervalo de solo lectura que contiene los bytes que representan un GUID.A read-only span containing the bytes representing a GUID.

Devoluciones

Guid

Estructura que contiene el valor que se analizó.A structure that contains the value that was parsed.

Excepciones

input no es un formato reconocido.input is not in a recognized format.

O bien-or-

Después del recorte, la longitud del intervalo de caracteres de solo lectura es 0.After trimming, the length of the read-only character span is 0.

Comentarios

El Parse método recorta los caracteres de espacio en blanco iniciales o finales de input y convierte los caracteres restantes de en input un Guid valor.The Parse method trims any leading or trailing white space characters from input and converts the remaining characters in input to a Guid value. Este método puede convertir un intervalo de caracteres que representa cualquiera de los cinco formatos generados por los ToString métodos, tal y como se muestra en la tabla siguiente.This method can convert a character span that represents any of the five formats produced by the ToString methods, as shown in the following table.

EspecificadorSpecifier DescripciónDescription FormatoFormat
N 32 dígitos32 digits 0000000000000000000000000000000000000000000000000000000000000000
D 32 dígitos separados por guiones32 digits separated by hyphens 00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 dígitos separados por guiones, entre llaves32 digits separated by hyphens, enclosed in braces {00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por guiones, entre paréntesis32 digits separated by hyphens, enclosed in parentheses (00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X Cuatro valores hexadecimales entre llaves, donde el cuarto valor es un subconjunto de ocho valores hexadecimales que también se incluye entre llavesFour hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

El método produce una excepción FormatException si no puede analizar correctamente la cadena.The method throws a FormatException if it is unable to successfully parse the string. Estas son algunas de las razones por las que esto puede ocurrir:Here are some of the reasons why this might occur include:

  • input contiene caracteres que no forman parte del juego de caracteres hexadecimales.input contains characters that are not part of the hexadecimal character set.

  • input tiene demasiados caracteres numéricos o demasiado pocos.input has too many or too few numeric characters.

  • input tiene demasiados o pocos caracteres no numéricos adecuados para un formato determinado.input has too many or too few of the non-numeric characters appropriate for a particular format.

  • input no se encuentra en uno de los formatos reconocidos por el ToString método y que se enumeran en la tabla anterior.input is not in one of the formats recognized by the ToString method and listed in the previous table.

Use el TryParse método para detectar cualquier operación de análisis incorrecta sin tener que controlar una excepción.Use the TryParse method to catch any unsuccessful parse operations without having to handle an exception.

Se aplica a