Guid.IFormattable.ToString(String, IFormatProvider) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System
Assembly:
System.Runtime.dll

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

 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

Parametri

format
String

Identificatore di formato singolo che indica le modalità di formattazione del valore dell'oggetto Guid. Il parametro format 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.

Restituisce

String

Valore dell'oggetto Guid, rappresentato come una serie di cifre esadecimali minuscole nel formato specificato.

Implementazioni

ToString(String, IFormatProvider)

Eccezioni

FormatException

Il valore di format non è Null né una stringa vuota ("") né alcuno dei seguenti identificatori di formato singoli, ovvero "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 maiuscolo, 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 Formattazione dei tipi .

Si applica a