Guid.IFormattable.ToString(String, IFormatProvider) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Devuelve una representación de cadena del valor de esta instancia de acuerdo con 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 -> string

Function ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString

Parámetros

format

String

Especificador de formato único que indica la forma de aplicar formato al valor del Guid. El parámetro format puede ser "N", "D", "B", "P" o "X". Si el valor de format es nulo o una cadena vacía (""), se usará "D".

provider

IFormatProvider

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

Devoluciones

String

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

Implementaciones

ToString(String, IFormatProvider)

Excepciones

FormatException

El valor de format no es nulo, una cadena vacía (""), o uno de los especificadores de formato siguientes: "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 se incluyen entre llaves: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Los dígitos hexadecimales a a 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 es compatible con las cadenas de formato GUID estándar, llame al String.Format(IFormatProvider, String, Object[]) método con un provider objeto que implementa 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 .