Guid.ToString Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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

Sobrecargas

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

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 hexadecimal minúsculos no formato especificado.

Exceções

FormatException

O valor de 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 ("(", ")") 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 método String.ToUpper na cadeia de caracteres retornada.

ToString()

Origem:

Guid.cs

Retorna uma representação de 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 deste 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 hexadecimal minúsculos em grupos de 8, 4, 4, 4 e 12 dígitos e separados por hifens. Um exemplo de um valor retornado é "382c74c3-721d-4f34-80e5-57657b6cbc27". Para converter os dígitos hexadecimal de um a f em maiúsculo, 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 parâmetro format fornecem algumas variações de formato comuns.

ToString(String, IFormatProvider)

Origem:

Guid.cs

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

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 da cultura.

Retornos

String

O valor desse 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 de format não é null, uma cadeia de caracteres vazia (""), "N", "D", "B", "P" ou "X".

Comentários

O parâmetro provider é reservado para uso futuro e não contribui para a execução desse método. Você pode passar null na 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 ("(", ")") 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 método String.ToUpper na cadeia de caracteres retornada.

Como o parâmetro provider é ignorado, você não pode usá-lo para fornecer uma solução de formatação personalizada. Para representar um valor Guid 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 método String.Format(IFormatProvider, String, Object[]) com um objeto provider que implementa as interfaces ICustomFormatter e IFormatProvider. Para obter mais informações, consulte a seção "Formatação Personalizada com ICustomFormatter" no artigo Tipos de Formatação.