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

Definição

Namespace:
System
Assemblies:
mscorlib.dll, System.Runtime.dll
Assembly:
System.Runtime.dll

Retorna uma representação de cadeia de caracteres do valor dessa instância, de acordo com o especificador de formato fornecido e as informações de formato específicas da 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

Parâmetros

format
String

Um especificador de formato único que indica como formatar o valor do Guid. O format parâmetro 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 da cultura.

Retornos

String

O valor disso Guid representado como uma série de dígitos hexadecimal minúsculos no formato especificado.

Implementações

ToString(String, IFormatProvider)

Exceções

FormatException

O valor não format é 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 de método.

A tabela a seguir mostra os especificadores de formato aceitos para o format parâmetro. "0" representa um dígito; Hifens ("-"), chaves ("{", "}" e parênteses ("(", ")") aparecem 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 hexadecimal entre chaves, em que o quarto valor é um subconjunto de oito valores hexadecimal que também está 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 as interfaces e ICustomFormatter as IFormatProvider interfaces. Para obter mais informações, consulte a seção "Formatação Personalizada com ICustomFormatter" no artigo Tipos de Formatação .

Aplica-se a