Guid.IFormattable.ToString(String, IFormatProvider) Metodo

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Runtime.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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