Guid.ToString Metodo

Definizione

Restituisce una rappresentazione di stringa del valore di questa istanza della struttura Guid.Returns a string representation of the value of this instance of the Guid structure.

Overload

ToString()

Restituisce una rappresentazione di stringa del valore di questa istanza nel formato del Registro di sistema.Returns a string representation of the value of this instance in registry format.

ToString(String)

Restituisce una rappresentazione di stringa del valore di questa istanza Guid, in base all'identificatore di formato specificato.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

ToString(String, IFormatProvider)

Restituisce una rappresentazione di stringa del valore di questa istanza della classe Guid, in base all'identificatore di formato fornito e alle informazioni di formato specifiche delle impostazioni cultura.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

ToString()

Restituisce una rappresentazione di stringa del valore di questa istanza nel formato del Registro di sistema.Returns a string representation of the value of this instance in registry format.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Restituisce

Valore di questo oggetto Guid, formattato utilizzando l'identificatore di formato "D" come indicato di seguito:The value of this Guid, formatted by using the "D" format specifier as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

dove il valore del GUID è rappresentato da una serie di cifre esadecimali minuscole disposte in gruppi di 8, 4, 4, 4 e 12 cifre separati da trattini.where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. Un esempio di valore restituito è "382c74c3-721d-4f34-80e5-57657b6cbc27".An example of a return value is "382c74c3-721d-4f34-80e5-57657b6cbc27". Per convertire le cifre esadecimali dalla a alla f in maiuscolo, chiamare il metodo ToUpper() sulla stringa restituita.To convert the hexadecimal digits from a through f to uppercase, call the ToUpper() method on the returned string.

Commenti

Questo metodo fornisce un formato GUID predefinito sufficiente per l'utilizzo tipico; Tuttavia, le altre versioni di questo metodo che accettano un parametro di format forniscono alcune varianti di formato comuni.This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a format parameter provide a few common format variations.

ToString(String)

Restituisce una rappresentazione di stringa del valore di questa istanza Guid, in base all'identificatore di formato specificato.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

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 le modalità di formattazione di Guid.A single format specifier that indicates how to format the value of this Guid. Il parametro format può essere "N", "D", "B", "P" o "X".The format parameter can be "N", "D", "B", "P", or "X". Se format è null o una stringa vuota (""), viene usato "D".If format is null or an empty string (""), "D" is used.

Restituisce

Valore dell'oggetto Guid, rappresentato come una serie di cifre esadecimali minuscole nel formato specificato.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Eccezioni

Il valore di format non è null, una stringa vuota (""), "N", "D", "B", "P" o "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Commenti

Nella tabella seguente vengono illustrati gli identificatori di formato accettati per il parametro format.The following table shows the accepted format specifiers for the format parameter. "0" rappresenta una cifra; i trattini ("-"), le parentesi graffe ("{", "}") e le parentesi ("(", ")") vengono visualizzati come illustrato."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

IdentificatoreSpecifier Formato del valore restituitoFormat of return value
N 32 cifre:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 cifre separate da trattini:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 cifre separate da trattini, racchiuse tra parentesi graffe:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 cifre separate da trattini, racchiuse tra parentesi:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(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:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Le cifre esadecimali da a a f sono minuscole nella stringa restituita.The hexadecimal digits a through f are lowercase in the returned string. Per convertirli in maiuscolo, chiamare il metodo String.ToUpper sulla stringa restituita.To convert them to uppercase, call the String.ToUpper method on the returned string.

ToString(String, IFormatProvider)

Restituisce una rappresentazione di stringa del valore di questa istanza della classe Guid, in base all'identificatore di formato fornito e alle informazioni di formato specifiche delle impostazioni cultura.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

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 le modalità di formattazione di Guid.A single format specifier that indicates how to format the value of this Guid. Il parametro format può essere "N", "D", "B", "P" o "X".The format parameter can be "N", "D", "B", "P", or "X". Se format è null o una stringa vuota (""), viene usato "D".If format is null or an empty string (""), "D" is used.

provider
IFormatProvider

(Riservato) Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.(Reserved) An object that supplies culture-specific formatting information.

Restituisce

Valore dell'oggetto Guid, rappresentato come una serie di cifre esadecimali minuscole nel formato specificato.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Implementazioni

Eccezioni

Il valore di format non è null, una stringa vuota (""), "N", "D", "B", "P" o "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Commenti

Il provider parametro è riservato per un utilizzo futuro e non contribuisce all'esecuzione di questo metodo.The provider parameter is reserved for future use and does not contribute to the execution of this method. È possibile passare null nella chiamata al metodo.You can pass null in the method call.

Nella tabella seguente vengono illustrati gli identificatori di formato accettati per il parametro format.The following table shows the accepted format specifiers for the format parameter. "0" rappresenta una cifra; i trattini ("-"), le parentesi graffe ("{", "}") e le parentesi ("(", ")") vengono visualizzati come illustrato."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

IdentificatoreSpecifier Formato del valore restituitoFormat of return value
N 32 cifre:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 cifre separate da trattini:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 cifre separate da trattini, racchiuse tra parentesi graffe:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 cifre separate da trattini, racchiuse tra parentesi:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(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:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Le cifre esadecimali da a a f sono minuscole nella stringa restituita.The hexadecimal digits a through f are lowercase in the returned string. Per convertirli in maiuscolo, chiamare il metodo String.ToUpper sulla stringa restituita.To convert them to uppercase, call the String.ToUpper method on the returned string.

Poiché il parametro provider viene ignorato, non è possibile usarlo per fornire una soluzione di formattazione personalizzata.Because the provider parameter is ignored, you cannot use it to provide a custom formatting solution. 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 implementi le interfacce ICustomFormatter e IFormatProvider.To represent a Guid value as a string in a format that isn't supported by the standard GUID format strings, call the String.Format(IFormatProvider, String, Object[]) method with a provider object that implements both the ICustomFormatter and IFormatProvider interfaces. Per ulteriori informazioni, vedere la sezione relativa alla formattazione personalizzata con ICustomFormatter nell'articolo formattazione dei tipi .For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

Si applica a