Guid.ToString Método

Definição

Retorna uma representação da cadeia de caracteres do valor dessa instância da estrutura Guid.Returns a string representation of the value of this instance of the Guid structure.

Sobrecargas

ToString()

Retorna uma representação da cadeia de caracteres do valor dessa instância no formato do Registro.Returns a string representation of the value of this instance in registry format.

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.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

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.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

ToString()

Retorna uma representação da cadeia de caracteres do valor dessa instância no formato do Registro.Returns a string representation of the value of this instance in registry format.

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:The value of this Guid, formatted by using the "D" format specifier as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-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.where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. Um exemplo de um valor retornado é "382c74c3-721d-4f34-80e5-57657b6cbc27".An example of a return value is "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.To convert the hexadecimal digits from a through f to uppercase, call the ToUpper() method on the returned string.

Comentários

Esse método fornece um formato de GUID padrão que é suficiente para uso típico; no entanto, outras versões desse método que usam um parâmetro format fornecem algumas variações de formato comuns.This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a format parameter provide a few common format variations.

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.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

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.A single format specifier that indicates how to format the value of this Guid. O parâmetro format pode ser "N", "D", "B", "P" ou "X".The format parameter can be "N", "D", "B", "P", or "X". Se format for null ou uma cadeia de caracteres vazia (“”), “D” será usado.If format is null or an empty string (""), "D" is used.

Retornos

O valor desse Guid, representado como uma série de dígitos hexadecimais em minúsculas no formato especificado.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Exceções

O valor format não é null, uma cadeia de caracteres vazia (""), "N", "D", "B", "P" ou "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Comentários

A tabela a seguir mostra os especificadores de formato aceitos para o parâmetro format.The following table shows the accepted format specifiers for the format parameter. "0" representa um dígito; hifens ("-"), chaves ("{", "}") e parênteses (“(”, ")”) são exibidos como mostrado."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

EspecificadorSpecifier Formato do valor de retornoFormat of return value
N 32 dígitos:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 dígitos separados por hifens:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 dígitos separados por hifens, entre chaves:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por hifens, entre parênteses:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(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:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}{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 de caracteres retornada.The hexadecimal digits a through f are lowercase in the returned string. Para convertê-los em maiúsculas, chame o método String.ToUpper na cadeia de caracteres retornada.To convert them to uppercase, call the String.ToUpper method on the returned string.

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.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

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.A single format specifier that indicates how to format the value of this Guid. O parâmetro format pode ser "N", "D", "B", "P" ou "X".The format parameter can be "N", "D", "B", "P", or "X". Se format for null ou uma cadeia de caracteres vazia (“”), “D” será usado.If format is null or an empty string (""), "D" is used.

provider
IFormatProvider

(Reservado) Um objeto que fornece informações de formatação específicas de cultura.(Reserved) An object that supplies culture-specific formatting information.

Retornos

O valor desse Guid, representado como uma série de dígitos hexadecimais em minúsculas no formato especificado.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Implementações

Exceções

O valor format não é null, uma cadeia de caracteres vazia (""), "N", "D", "B", "P" ou "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Comentários

O parâmetro provider é reservado para uso futuro e não contribui para a execução desse método.The provider parameter is reserved for future use and does not contribute to the execution of this method. Você pode passar null na chamada do método.You can pass null in the method call.

A tabela a seguir mostra os especificadores de formato aceitos para o parâmetro format.The following table shows the accepted format specifiers for the format parameter. "0" representa um dígito; hifens ("-"), chaves ("{", "}") e parênteses (“(”, ")”) são exibidos como mostrado."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

EspecificadorSpecifier Formato do valor de retornoFormat of return value
N 32 dígitos:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 dígitos separados por hifens:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 dígitos separados por hifens, entre chaves:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por hifens, entre parênteses:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(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:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}{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 de caracteres retornada.The hexadecimal digits a through f are lowercase in the returned string. Para convertê-los em maiúsculas, chame o método String.ToUpper na cadeia de caracteres retornada.To convert them to uppercase, call the String.ToUpper method on the returned string.

Como o parâmetro provider é ignorado, você não pode usá-lo para fornecer uma solução de formatação personalizada.Because the provider parameter is ignored, you cannot use it to provide a custom formatting solution. Para representar um valor de Guid como uma cadeia de caracteres em um formato que não é suportado pelas 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.To represent a Guid value as a string in a format that isn't supported by the standard GUID format strings, call the String.Format(IFormatProvider, String, Object[]) method with a provider object that implements both the ICustomFormatter and IFormatProvider interfaces. Para obter mais informações, consulte a seção "formatação personalizada com ICustomFormatter" no artigo tipos de formatação .For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

Aplica-se a