Guid.ToString Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- Guid.cs
- 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);
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
O valor desse Guid, representado como uma série de dígitos hexadecimais em minúsculas no formato especificado.
Implementações
Exceções
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 .
Aplica-se a
ToString()
- Origem:
- Guid.cs
- Origem:
- Guid.cs
- 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
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.
Aplica-se a
ToString(String)
- Origem:
- Guid.cs
- Origem:
- Guid.cs
- 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);
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
O valor desse Guid, representado como uma série de dígitos hexadecimais em minúsculas no formato especificado.
Exceções
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.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários