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

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll

Devolve uma representação em cadeia do valor desta instância, de acordo com o especificador de formato fornecido e informações específicas de formato 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 único especificador de formato 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 vazia (""), usa-se "D".

provider
IFormatProvider

(Reservado) Um objeto que fornece informação de formatação específica para cada cultura.

Devoluções

String

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

Implementações

ToString(String, IFormatProvider)

Exceções

FormatException

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

Observações

O provider parâmetro é reservado para uso futuro e não contribui para a execução deste método. Podes passar null na chamada de método.

A tabela seguinte mostra os especificadores de formato aceites para o format parâmetro. "0" representa um dígito; hífens ("-"), colchetes ("{", "}") e parênteses ("(", ")") aparecem conforme mostrado.

Especificador Formato do valor de retorno
N 32 dígitos:

00000000000000000000000000000000
D 32 dígitos separados por hífens:

00000000-0000-0000-0000-000000000000
B 32 dígitos separados por hífens, contidos entre colchetes:

{00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por hífens, entre parênteses:

(00000000-0000-0000-0000-000000000000)
X Quatro valores hexadecimais contidos entre colchetes, onde o quarto valor é um subconjunto de oito valores hexadecimais que também está incluído entre colchetes:

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

Os dígitos hexadecimais de a a f são minúsculos na cadeia devolvida. Para os converter em maiúsculas, chama-se o String.ToUpper método na sequência devolvida.

Como o provider parâmetro é ignorado, não pode usá-lo para fornecer uma solução de formatação personalizada. Para representar um Guid valor como uma string num formato que não é suportado pelas strings de formato GUID padrão, chame o String.Format(IFormatProvider, String, Object[]) método com um provider objeto que implemente ambas as ICustomFormatter interfaces e.IFormatProvider Para mais informações, consulte a secção "Formatação Personalizada com o ICustomFormatter" no artigo Tipos de Formatação .

Aplica-se a