Guid.ToString Guid.ToString Guid.ToString Guid.ToString Method

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() ToString() ToString() 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) ToString(String) ToString(String) 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) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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() ToString() ToString() 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

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 format un parámetro 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) ToString(String) ToString(String) 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 String String 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

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 format aceptados para el parámetro.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) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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 String String 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 IFormatProvider IFormatProvider 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

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 provider parámetro 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 la llamada al método.You can pass null in the method call.

En la tabla siguiente se muestran los especificadores de formato format aceptados para el parámetro.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 provider el parámetro se omite, no se puede usar 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 Guid valor como una cadena en un formato que no es compatible con las cadenas de formato de GUID estándar String.Format(IFormatProvider, String, Object[]) , llame al provider método con un objeto que implemente IFormatProvider las ICustomFormatter interfaces y.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