Guid.ToString Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Devuelve una representación de cadena del valor de esta instancia de la estructura Guid.

Sobrecargas

ToString(String)	Devuelve una representación de cadena del valor de esta instancia de Guid, según el especificador de formato proporcionado.
ToString()	Devuelve una representación de cadena del valor de esta instancia en formato del Registro.
ToString(String, IFormatProvider)	Devuelve una representación de cadena del valor de esta instancia de la clase Guid, según el especificador de formato proporcionado y la información de formato específica de la referencia cultural.

ToString(String)

Source:

Guid.cs

Devuelve una representación de cadena del valor de esta instancia de Guid, según el especificador de formato proporcionado.

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 cómo dar formato al valor de este Guid. El parámetro format puede ser "N", "D", "B", "P" o "X". Si format es null o se usa una cadena vacía (""), se usa "D".

Devoluciones

String

El valor de este Guid, representado como una serie de dígitos hexadecimales en minúsculas en el formato especificado.

Excepciones

FormatException

El valor de format no es null, una cadena vacía (""), "N", "D", "B", "P" o "X".

Comentarios

En la tabla siguiente se muestran los especificadores de formato aceptados para el parámetro format. "0" representa un dígito; Los guiones ("-"), las llaves ("{", "}") y los paréntesis ("(", ")") aparecen como se muestra.

Especificador	Formato del valor devuelto
N	32 dígitos: 00000000000000000000000000000000
D	32 dígitos separados por guiones: 00000000-0000-0000-0000-000000000000
B	32 dígitos separados por guiones, entre llaves: {00000000-0000-0000-0000-000000000000}
P	32 dígitos separados por guiones, entre paréntesis: (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 están entre llaves: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Los dígitos hexadecimales a a través de f están en minúsculas en la cadena devuelta. Para convertirlos en mayúsculas, llame al método String.ToUpper en la cadena devuelta.

ToString()

Source:

Guid.cs

Devuelve una representación de cadena del valor de esta instancia en formato del Registro.

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 formato mediante el especificador de formato "D" como se indica a continuación:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

donde el valor del GUID se representa como una serie de dígitos hexadecimales en minúsculas en grupos de 8, 4, 4, 4 y 12 dígitos y separados por guiones. Un ejemplo de un valor devuelto es "382c74c3-721d-4f34-80e5-57657b6cbc27". Para convertir los dígitos hexadecimales de un a f a mayúsculas, llame al método ToUpper() en la cadena devuelta.

Comentarios

Este método proporciona un formato 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.

ToString(String, IFormatProvider)

Source:

Guid.cs

Devuelve una representación de cadena del valor de esta instancia de la clase Guid, según el especificador de formato proporcionado y la información de formato específica de la referencia cultural.

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 cómo dar formato al valor de este Guid. El parámetro format puede ser "N", "D", "B", "P" o "X". Si format es null o se usa una cadena vacía (""), se usa "D".

provider

IFormatProvider

(Reservado) Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

String

El valor de este Guid, representado como una serie de dígitos hexadecimales en minúsculas en el formato especificado.

Implementaciones

ToString(String, IFormatProvider)

Excepciones

FormatException

El valor de format no es null, una cadena vacía (""), "N", "D", "B", "P" o "X".

Comentarios

El parámetro provider está reservado para uso futuro y no contribuye a la ejecución de este método. Puede pasar null en la llamada al método .

En la tabla siguiente se muestran los especificadores de formato aceptados para el parámetro format. "0" representa un dígito; Los guiones ("-"), las llaves ("{", "}") y los paréntesis ("(", ")") aparecen como se muestra.

Especificador	Formato del valor devuelto
N	32 dígitos: 00000000000000000000000000000000
D	32 dígitos separados por guiones: 00000000-0000-0000-0000-000000000000
B	32 dígitos separados por guiones, entre llaves: {00000000-0000-0000-0000-000000000000}
P	32 dígitos separados por guiones, entre paréntesis: (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 están entre llaves: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Los dígitos hexadecimales a a través de f están en minúsculas en la cadena devuelta. Para convertirlos en mayúsculas, llame al método String.ToUpper en la cadena devuelta.

Dado que se omite el parámetro provider, no se puede usar para proporcionar una solución de formato personalizada. Para representar un valor de Guid como una cadena en un formato que no sea 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. Para obtener más información, vea la sección "Formato personalizado con ICustomFormatter" del artículo Tipos de formato.