Guid.ToString Método

Definición

Espacio de nombres:
System
Ensamblados:
mscorlib.dll, System.Runtime.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

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

Sobrecargas

Nombre Description
ToString(String)

Devuelve una representación de cadena del valor de esta Guid instancia, 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 Guid clase, 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
Source:
Guid.cs
Source:
Guid.cs

Devuelve una representación de cadena del valor de esta Guid instancia, 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 -> 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 format parámetro puede ser "N", "D", "B", "P" o "X". Si format es null o una cadena vacía (""), se usa "D".

Devoluciones

String

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

Excepciones

FormatException

El valor de format no nulles , una cadena vacía (""), "N", "D", "B", "P" o "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 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.

Se aplica a

ToString()

Source:
Guid.cs
Source:
Guid.cs
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 -> 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 ToUpper() método 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 format parámetro proporcionan algunas variaciones de formato comunes.

Se aplica a

ToString(String, IFormatProvider)

Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

Devuelve una representación de cadena del valor de esta instancia de la Guid clase, 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 -> 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 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

String

El valor de , Guidrepresentado 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 nulles , una cadena vacía (""), "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 .

Se aplica a