Guid.ToString Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Restituisce una rappresentazione di stringa del valore di questa istanza della struttura Guid.

Overload

ToString(String)	Restituisce una rappresentazione di stringa del valore di questa istanza di Guid, in base all'identificatore di formato fornito.
ToString()	Restituisce una rappresentazione di stringa del valore di questa istanza nel formato del Registro di sistema.
ToString(String, IFormatProvider)	Restituisce una rappresentazione di stringa del valore di questa istanza della classe Guid, in base all'identificatore di formato specificato e alle informazioni sul formato specifiche delle impostazioni cultura.

ToString(String)

Origine:

Guid.cs

Restituisce una rappresentazione di stringa del valore di questa istanza di Guid, in base all'identificatore di formato fornito.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Parametri

format

String

Identificatore di formato singolo che indica come formattare il valore di questo Guid. Il parametro format può essere "N", "D", "B", "P" o "X". Se format è null o viene usata una stringa vuota (""), "D".

Restituisce

String

Valore di questo Guid, rappresentato come una serie di cifre esadecimali minuscole nel formato specificato.

Eccezioni

FormatException

Il valore di format non è null, una stringa vuota (""), "N", "D", "B", "P" o "X".

Commenti

Nella tabella seguente vengono illustrati gli identificatori di formato accettati per il parametro format. "0" rappresenta una cifra; i trattini ("-"), le parentesi graffe ("{", "}") e le parentesi ("(", ")") vengono visualizzate come illustrato.

Identificatore	Formato del valore restituito
N	32 cifre: 00000000000000000000000000000000
D	32 cifre separate da trattini: 00000000-0000-0000-0000-000000000000
B	32 cifre separate da trattini, racchiuse tra parentesi graffe: {00000000-0000-0000-0000-000000000000}
P	32 cifre separate da trattini, racchiuse tra parentesi: (00000000-0000-0000-0000-000000000000)
X	Quattro valori esadecimali racchiusi tra parentesi graffe, dove il quarto valore è un subset di otto valori esadecimali racchiusi tra parentesi graffe: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Le cifre esadecimali da a f sono minuscole nella stringa restituita. Per convertirli in maiuscolo, chiamare il metodo String.ToUpper sulla stringa restituita.

ToString()

Origine:

Guid.cs

Restituisce una rappresentazione di stringa del valore di questa istanza nel formato del Registro di sistema.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Restituisce

String

Il valore di questa Guid, formattato usando l'identificatore di formato "D" come indicato di seguito:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

dove il valore del GUID è rappresentato come una serie di cifre esadecimali minuscole in gruppi di 8, 4, 4, 4 e 12 cifre e separati da trattini. Un esempio di valore restituito è "382c74c3-721d-4f34-80e5-57657b6cbc27". Per convertire le cifre esadecimali da a f in maiuscolo, chiamare il metodo ToUpper() sulla stringa restituita.

Commenti

Questo metodo fornisce un formato GUID predefinito sufficiente per l'uso tipico; Tuttavia, altre versioni di questo metodo che accettano un parametro format forniscono alcune varianti di formato comuni.

ToString(String, IFormatProvider)

Origine:

Guid.cs

Restituisce una rappresentazione di stringa del valore di questa istanza della classe Guid, in base all'identificatore di formato specificato e alle informazioni sul formato specifiche delle impostazioni cultura.

public:
 virtual System::String ^ ToString(System::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

Parametri

format

String

Identificatore di formato singolo che indica come formattare il valore di questo Guid. Il parametro format può essere "N", "D", "B", "P" o "X". Se format è null o viene usata una stringa vuota (""), "D".

provider

IFormatProvider

(Riservato) Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.

Restituisce

String

Valore di questo Guid, rappresentato come una serie di cifre esadecimali minuscole nel formato specificato.

Implementazioni

ToString(String, IFormatProvider)

Eccezioni

FormatException

Il valore di format non è null, una stringa vuota (""), "N", "D", "B", "P" o "X".

Commenti

Il parametro provider è riservato per uso futuro e non contribuisce all'esecuzione di questo metodo. È possibile passare null nella chiamata al metodo.

Nella tabella seguente vengono illustrati gli identificatori di formato accettati per il parametro format. "0" rappresenta una cifra; i trattini ("-"), le parentesi graffe ("{", "}") e le parentesi ("(", ")") vengono visualizzate come illustrato.

Identificatore	Formato del valore restituito
N	32 cifre: 00000000000000000000000000000000
D	32 cifre separate da trattini: 00000000-0000-0000-0000-000000000000
B	32 cifre separate da trattini, racchiuse tra parentesi graffe: {00000000-0000-0000-0000-000000000000}
P	32 cifre separate da trattini, racchiuse tra parentesi: (00000000-0000-0000-0000-000000000000)
X	Quattro valori esadecimali racchiusi tra parentesi graffe, dove il quarto valore è un subset di otto valori esadecimali racchiusi tra parentesi graffe: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Le cifre esadecimali da a f sono minuscole nella stringa restituita. Per convertirli in maiuscolo, chiamare il metodo String.ToUpper sulla stringa restituita.

Poiché il parametro provider viene ignorato, non è possibile usarlo per fornire una soluzione di formattazione personalizzata. Per rappresentare un valore Guid come stringa in un formato non supportato dalle stringhe di formato GUID standard, chiamare il metodo String.Format(IFormatProvider, String, Object[]) con un oggetto provider che implementa le interfacce sia ICustomFormatter che IFormatProvider. Per altre informazioni, vedere la sezione "Formattazione personalizzata con ICustomFormatter" nell'articolo Formattazione dei tipi.