Guid.IFormattable.ToString(String, IFormatProvider) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Retorna uma representação de cadeia de caracteres do valor desta instância, de acordo com as informações de formato específicas da cultura e com o especificador de formato fornecido.

 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

Parâmetros

format

String

Um especificador de formato único que indica como formatar o valor do Guid. O parâmetro format pode ser "N", "D", "B", "P" ou "X". Se format for nulo ou uma cadeia de caracteres vazia (""), "D" será usado.

provider

IFormatProvider

(Reservado) Um objeto que fornece informações de formatação específicas de cultura.

Retornos

String

O valor desse Guid, representado como uma série de dígitos hexadecimais em minúsculas no formato especificado.

Implementações

ToString(String, IFormatProvider)

Exceções

FormatException

O valor de format não é nulo, uma cadeia de caracteres vazia ("") ou um dos seguintes especificadores de formato único: "N", "D", "B", "P" ou "X".

Comentários

O provider parâmetro é reservado para uso futuro e não contribui para a execução desse método. Você pode passar null a chamada do método.

A tabela a seguir mostra os especificadores de formato aceitos para o parâmetro format. "0" representa um dígito; hifens ("-"), chaves ("{", "}") e parênteses (“(”, ")”) são exibidos como mostrado.

Especificador	Formato do valor retornado
N	32 dígitos: 00000000000000000000000000000000
D	32 dígitos separados por hifens: 00000000-0000-0000-0000-000000000000
B	32 dígitos separados por hifens, entre chaves: {00000000-0000-0000-0000-000000000000}
P	32 dígitos separados por hifens, entre parênteses: (00000000-0000-0000-0000-000000000000)
X	Quatro valores hexadecimais entre chaves, em que o quarto valor é um subconjunto de oito valores hexadecimais que também é incluído entre chaves: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Os dígitos hexadecimal de um a f são minúsculos na cadeia de caracteres retornada. Para convertê-los em maiúsculas, chame o String.ToUpper método na cadeia de caracteres retornada.

Como o provider parâmetro é ignorado, você não pode usá-lo para fornecer uma solução de formatação personalizada. Para representar um Guid valor como uma cadeia de caracteres em um formato que não é compatível com as cadeias de caracteres de formato GUID padrão, chame o String.Format(IFormatProvider, String, Object[]) método com um provider objeto que implementa tanto as interfaces quanto IFormatProvider as ICustomFormatter interfaces. Para obter mais informações, consulte a seção "Formatação personalizada com ICustomFormatter" no artigo Tipos de Formatação .