Guid.ToString Método

Definición

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

Sobrecargas

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.

ToString()

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

ToString(String)

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

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.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (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. El parámetro format puede ser "N", "D", "B", "P" o "X". Si format es null o una cadena vacía (""), se usa "D".

provider
IFormatProvider

(Reservado) Un objeto que aporta información de formato específica de la referencia cultural.

Devoluciones

Valor de este Guid, representado como una serie de dígitos hexadecimales en minúscula con el formato especificado.

Implementaciones

Excepciones

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

Comentarios

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

En la tabla siguiente se muestran los especificadores de formato aceptados para el format parámetro . "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 se incluyen entre llaves:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

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

Dado que el provider parámetro se omite, no se puede usar para proporcionar una solución de formato personalizada. Para representar un Guid valor como una cadena en un formato que no sea compatible con las cadenas de formato GUID estándar, llame al String.Format(IFormatProvider, String, Object[]) método con un provider objeto que implemente las ICustomFormatter interfaces y IFormatProvider . Para obtener más información, vea la sección "Formato personalizado con ICustomFormatter" en el artículo Tipos de formato .

Se aplica a

ToString()

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

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:

xxxxxxxx-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. Un ejemplo de un valor devuelto es "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.

Comentarios

Este método proporciona un formato GUID predeterminado que es suficiente para uso típico; sin embargo, otras versiones de este método que toman un format parámetro proporcionan algunas variaciones de formato comunes.

Se aplica a

ToString(String)

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

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (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. El parámetro format puede ser "N", "D", "B", "P" o "X". Si format es null o una cadena vacía (""), se usa "D".

Devoluciones

Valor de este Guid, representado como una serie de dígitos hexadecimales en minúscula con el formato especificado.

Excepciones

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

Comentarios

En la tabla siguiente se muestran los especificadores de formato aceptados para el format parámetro . "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 se incluyen entre llaves:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

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

Se aplica a