Guid.IFormattable.ToString(String, IFormatProvider) 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, según el especificador de formato proporcionado y la información de formato específica de la referencia cultural.
virtual System::String ^ System.IFormattable.ToString(System::String ^ format, IFormatProvider ^ provider) = IFormattable::ToString;string IFormattable.ToString(string format, IFormatProvider provider);abstract member System.IFormattable.ToString : string * IFormatProvider -> string
override this.System.IFormattable.ToString : string * IFormatProvider -> stringFunction ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToStringParámetros
- format
- String
Especificador de formato único que indica cómo dar formato al valor de Guid. El format parámetro puede ser "N", "D", "B", "P" o "X". Si format es null o 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 objeto representado como una serie de dígitos hexadecimales en minúsculas en el formato especificado.
Implementaciones
Excepciones
El valor de no es NULL, una cadena vacía (""), o uno de los siguientes especificadores de format formato único:"N", "D", "B", "P" o "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 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 String.ToUpper método en 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 es 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 .
