Guid.ToString Método

Definição

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

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

Sobrecargas

Nome Description
ToString(String)

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

ToString(String)

Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs

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

public:
 System::String ^ ToString(System::String ^ format);
public string ToString(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 deste Guid. O format parâmetro pode ser "N", "D", "B", "P" ou "X". Se format for ou uma null cadeia de caracteres vazia (""), "D" será usado.

Retornos

String

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

Exceções

FormatException

O valor não formatnullé , 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 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.

Aplica-se a

ToString()

Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs
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 disso 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 ToUpper() método 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.

Aplica-se a

ToString(String, IFormatProvider)

Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs

Retorna uma representação de cadeia de caracteres do valor dessa instância da Guid classe, 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);
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 deste Guid. O format parâmetro pode ser "N", "D", "B", "P" ou "X". Se format for ou uma null 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 formatnullé , 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 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