Guid.ToString Metodo

Definizione

Spazio dei nomi:
System
Assembly:
mscorlib.dll, System.Runtime.dll
Assembly:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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

Overload

Nome Descrizione
ToString(String)

Restituisce una rappresentazione di stringa del valore di questa Guid istanza, 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 Guid classe, in base all'identificatore di formato specificato e alle informazioni sul formato specifiche delle impostazioni cultura.

ToString(String)

Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs

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

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

Parametri

format
String

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

Valori restituiti

String

Valore di questo Guidoggetto , 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 format parametro . "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 lettere maiuscole, chiamare il String.ToUpper metodo sulla stringa restituita.

Si applica a

ToString()

Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs
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

Valori restituiti

String

Valore di questo Guidoggetto , 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 ToUpper() metodo 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 format parametro forniscono alcune varianti di formato comuni.

Si applica a

ToString(String, IFormatProvider)

Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs
Origine:
Guid.cs

Restituisce una rappresentazione di stringa del valore di questa istanza della Guid classe, 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);
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 .Guid Il format parametro può essere "N", "D", "B", "P" o "X". Se format è null o una stringa vuota (""), viene usato "D".

provider
IFormatProvider

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

Valori restituiti

String

Valore di questo Guidoggetto , 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 provider parametro è riservato per uso futuro e non contribuisce all'esecuzione di questo metodo. È possibile passare null la chiamata al metodo.

Nella tabella seguente vengono illustrati gli identificatori di formato accettati per il format parametro . "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 lettere maiuscole, chiamare il String.ToUpper metodo sulla stringa restituita.

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

Si applica a