Guid.ToString Método

Definición

Devuelve una representación de cadena del valor de esta instancia de la estructura Guid.Returns a string representation of the value of this instance of the Guid structure.

Sobrecargas

ToString()

Devuelve una representación de cadena del valor de esta instancia con formato del Registro.Returns a string representation of the value of this instance in registry format.

ToString(String)

Devuelve una representación de cadena del valor de esta instancia de Guid, de acuerdo con el especificador de formato proporcionado.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

ToString(String, IFormatProvider)

Devuelve una representación de cadena del valor de esta instancia de la clase Guid, de acuerdo con el especificador de formato proporcionado y la información de formato específica de la referencia cultural.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

ToString()

Devuelve una representación de cadena del valor de esta instancia con formato del Registro.Returns a string representation of the value of this instance in registry format.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Devoluciones

String

El valor de este Guid, con el especificador de formato “D” como sigue:The value of this Guid, formatted by using the "D" format specifier as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

donde el valor del identificador GUID se representa como una serie de dígitos hexadecimales en minúscula en grupos de 8, 4, 4, 4 y 12 dígitos separados por guiones.where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. Un ejemplo de un valor devuelto es "382c74c3-721d-4f34-80e5-57657b6cbc27".An example of a return value is "382c74c3-721d-4f34-80e5-57657b6cbc27". Para convertir los dígitos hexadecimales utilizando las mayúsculas desde la a hasta la f, llame al método ToUpper() en la cadena devuelta.To convert the hexadecimal digits from a through f to uppercase, call the ToUpper() method on the returned string.

Comentarios

Este método proporciona un formato de GUID predeterminado que es suficiente para el uso típico; sin embargo, otras versiones de este método que toman un parámetro format proporcionan algunas variaciones de formato comunes.This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a format parameter provide a few common format variations.

ToString(String)

Devuelve una representación de cadena del valor de esta instancia de Guid, de acuerdo con el especificador de formato proporcionado.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parámetros

format
String

Especificador de formato único que indica la forma de aplicar formato al valor de este Guid.A single format specifier that indicates how to format the value of this Guid. El parámetro format puede ser "N", "D", "B", "P" o "X".The format parameter can be "N", "D", "B", "P", or "X". Si format es null o una cadena vacía (""), se usa "D".If format is null or an empty string (""), "D" is used.

Devoluciones

String

Valor de este Guid, representado como una serie de dígitos hexadecimales en minúscula con el formato especificado.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Excepciones

El valor de format no es null, una cadena vacía (""), "N", "D", "B", "P" ni "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Comentarios

En la tabla siguiente se muestran los especificadores de formato aceptados para el parámetro format.The following table shows the accepted format specifiers for the format parameter. "0" representa un dígito; los guiones ("-"), las llaves ("{", "}") y los paréntesis ("(", ")") aparecen como se muestra."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

EspecificadorSpecifier Formato del valor devueltoFormat of return value
N 32 dígitos:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 dígitos separados por guiones:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 dígitos separados por guiones, entre llaves:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por guiones, entre paréntesis:32 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 llaves:Four 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}}

Los dígitos hexadecimales de la a a la f aparecen en minúsculas en la cadena devuelta.The hexadecimal digits a through f are lowercase in the returned string. Para convertirlos a mayúsculas, llame al métod String.ToUpper de la cadena devuelta.To convert them to uppercase, call the String.ToUpper method on the returned string.

ToString(String, IFormatProvider)

Devuelve una representación de cadena del valor de esta instancia de la clase Guid, de acuerdo con el especificador de formato proporcionado y la información de formato específica de la referencia cultural.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parámetros

format
String

Especificador de formato único que indica la forma de aplicar formato al valor de este Guid.A single format specifier that indicates how to format the value of this Guid. El parámetro format puede ser "N", "D", "B", "P" o "X".The format parameter can be "N", "D", "B", "P", or "X". Si format es null o una cadena vacía (""), se usa "D".If format is null or an empty string (""), "D" is used.

provider
IFormatProvider

(Reservado) Un objeto que aporta información de formato específica de la referencia cultural.(Reserved) An object that supplies culture-specific formatting information.

Devoluciones

String

Valor de este Guid, representado como una serie de dígitos hexadecimales en minúscula con el formato especificado.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Implementaciones

Excepciones

El valor de format no es null, una cadena vacía (""), "N", "D", "B", "P" ni "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Comentarios

El parámetro provider se reserva para uso futuro y no contribuye a la ejecución de este método.The provider parameter is reserved for future use and does not contribute to the execution of this method. Puede pasar null en la llamada al método.You can pass null in the method call.

En la tabla siguiente se muestran los especificadores de formato aceptados para el parámetro format.The following table shows the accepted format specifiers for the format parameter. "0" representa un dígito; los guiones ("-"), las llaves ("{", "}") y los paréntesis ("(", ")") aparecen como se muestra."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

EspecificadorSpecifier Formato del valor devueltoFormat of return value
N 32 dígitos:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 dígitos separados por guiones:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 dígitos separados por guiones, entre llaves:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por guiones, entre paréntesis:32 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 llaves:Four 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}}

Los dígitos hexadecimales de la a a la f aparecen en minúsculas en la cadena devuelta.The hexadecimal digits a through f are lowercase in the returned string. Para convertirlos a mayúsculas, llame al métod String.ToUpper de la cadena devuelta.To convert them to uppercase, call the String.ToUpper method on the returned string.

Dado que el parámetro provider se omite, no se puede utilizar para proporcionar una solución de formato personalizada.Because the provider parameter is ignored, you cannot use it to provide a custom formatting solution. Para representar un valor Guid como una cadena en un formato que no es compatible con las cadenas de formato GUID estándar, llame al método String.Format(IFormatProvider, String, Object[]) con un objeto provider que implementa las interfaces ICustomFormatter y IFormatProvider.To represent a Guid value as a string in a format that isn't supported by the standard GUID format strings, call the String.Format(IFormatProvider, String, Object[]) method with a provider object that implements both the ICustomFormatter and IFormatProvider interfaces. Para obtener más información, vea la sección sobre el formato personalizado con ICustomFormatter en el artículo aplicar formato a tipos .For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

Se aplica a