Guid.ToString Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- Guid.cs
- 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);public string ToString (string? format);override this.ToString : string -> stringPublic Function ToString (format As String) As StringPará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
El valor de este Guid, representado como una serie de dígitos hexadecimales en minúsculas en el formato especificado.
Excepciones
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.
Se aplica a
ToString()
- Source:
- Guid.cs
- Source:
- Guid.cs
- 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 -> stringPublic Overrides Function ToString () As StringDevoluciones
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.
Se aplica a
ToString(String, IFormatProvider)
- Source:
- Guid.cs
- Source:
- Guid.cs
- 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);public string ToString (string format, IFormatProvider provider);override this.ToString : string * IFormatProvider -> stringPublic Function ToString (format As String, provider As IFormatProvider) As StringPará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
El valor de este Guid, representado como una serie de dígitos hexadecimales en minúsculas en el formato especificado.
Implementaciones
Excepciones
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.
