Guid.ToString Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Retorna uma representação da cadeia de caracteres do valor dessa instância da estrutura Guid.

Sobrecargas

ToString(String, IFormatProvider)	Retorna uma representação de cadeia de caracteres do valor desta instância da classe Guid, de acordo com as informações de formato específicas da cultura e com o especificador de formato fornecido.
ToString()	Retorna uma representação da cadeia de caracteres do valor dessa instância no formato do Registro.
ToString(String)	Retorna uma representação de cadeia de caracteres do valor desta instância de Guid, de acordo com o especificador de formato fornecido.

ToString(String, IFormatProvider)

Origem:

Guid.cs

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

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Parâmetros

format

String

Um especificador de formato único que indica como formatar o valor desse Guid. O parâmetro format pode ser "N", "D", "B", "P" ou "X". Se format for null 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 format não é null, uma cadeia de caracteres vazia (""), "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 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 hexadecimais 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 ICustomFormatter interfaces e IFormatProvider . Para obter mais informações, consulte a seção "Formatação personalizada com ICustomFormatter" no artigo Tipos de Formatação .

ToString()

Origem:

Guid.cs

Retorna uma representação da cadeia de caracteres do valor dessa instância no formato do Registro.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retornos

String

O valor desse Guid, formatado usando o especificador de formato "D" da seguinte maneira:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

em que o valor do GUID é representado como uma série de dígitos hexadecimais em letras minúsculas em grupos de 8, 4, 4, 4 e 12 dígitos e separado por hifens. Um exemplo de um valor retornado é "382c74c3-721d-4f34-80e5-57657b6cbc27". Para converter os dígitos hexadecimais de a até f em maiúsculas, chame o método ToUpper() na cadeia de caracteres retornada.

Comentários

Esse método fornece um formato GUID padrão suficiente para uso típico; no entanto, outras versões desse método que tomam um format parâmetro fornecem algumas variações de formato comuns.

ToString(String)

Origem:

Guid.cs

Retorna uma representação de cadeia de caracteres do valor desta instância de Guid, de acordo com o especificador de formato fornecido.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Parâmetros

format

String

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

Retornos

String

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

Exceções

FormatException

O valor format não é null, uma cadeia de caracteres vazia (""), "N", "D", "B", "P" ou "X".

Comentários

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 hexadecimais 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.