Guid.Parse Guid.Parse Guid.Parse Guid.Parse Method

Definición

Sobrecargas

Parse(String) Parse(String) Parse(String) 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>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>)

Parse(String) Parse(String) Parse(String) 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 String String String

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

Devoluciones

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.

Ejemplos

El ejemplo siguiente se crea un nuevo GUID, lo convierte en tres representaciones de cadena separada mediante una llamada a la ToString(String) método con la "B", "D" y "X" especificadores de formato y, después, llama el Parse nuevo método para convertir las cadenas a 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.

using System;

public class Example
{
   public static void Main()
   {
      Guid 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 {0} to a Guid", stringGuid);
         }   
         catch (ArgumentNullException) {
            Console.WriteLine("The string to be parsed is null.");   
         }                                   
         catch (FormatException) {
            Console.WriteLine("Bad format: {0}", stringGuid);
         }
      }                                      
   }
}
// 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
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 cualquier espacio en blanco inicial o final de input y convierte la representación de cadena de un GUID a 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 el ToString(String) y ToString(String, IFormatProvider) métodos, 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, incluya 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 encierra 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 FormatException si no puede analizar la cadena correctamente.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 incluyen: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 o muy pocos caracteres numéricos.input has too many or too few numeric characters.

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

  • input no está en uno de los formatos reconocidos por el ToString método y 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 incorrecto 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:

Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>)

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

Devoluciones

Se aplica a