Guid.ToString Método

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Devolve uma representação em cadeia do valor desta instância da Guid estrutura.

Sobrecargas

Name	Description
ToString(String)	Devolve uma representação em cadeia do valor desta Guid instância, de acordo com o especificador de formato fornecido.
ToString()	Devolve uma representação em cadeia do valor desta instância em formato de registo.
ToString(String, IFormatProvider)	Devolve uma representação string do valor desta instância da Guid classe, de acordo com o especificador de formato fornecido e informação de formato específica para cultura.

ToString(String)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Devolve uma representação em cadeia do valor desta 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 único especificador de formato que indica como formatar o valor deste Guid. O format parâmetro pode ser "N", "D", "B", "P" ou "X". Se format for null ou uma cadeia vazia (""), é usada a "D".

Devoluções

String

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

Exceções

FormatException

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

Observações

A tabela seguinte mostra os especificadores de formato aceites para o format parâmetro. "0" representa um dígito; hífens ("-"), colchetes ("{", "}") e parênteses ("(", ")") aparecem conforme mostrado.

Especificador	Formato do valor de retorno
`N`	32 dígitos: 00000000000000000000000000000000
`D`	32 dígitos separados por hífens: 00000000-0000-0000-0000-000000000000
`B`	32 dígitos separados por hífens, contidos entre colchetes: {00000000-0000-0000-0000-000000000000}
`P`	32 dígitos separados por hífens, entre parênteses: (00000000-0000-0000-0000-000000000000)
`X`	Quatro valores hexadecimais contidos entre colchetes, onde o quarto valor é um subconjunto de oito valores hexadecimais que também está incluído entre colchetes: {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 devolvida. Para os converter em maiúsculas, chama-se o String.ToUpper método na sequência devolvida.

Aplica-se a

ToString()

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Devolve uma representação em cadeia do valor desta instância em formato de registo.

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Devoluções

String

O valor deste Guid, formatado usando o especificador de formato "D" da seguinte forma:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

onde o valor do GUID é representado como uma série de dígitos hexadecimais minúsculos em grupos de 8, 4, 4, 4 e 12 dígitos e separados por hífens. Um exemplo de valor de retorno é "382c74c3-721d-4f34-80e5-57657b6cbc27". Para converter os dígitos hexadecimais de a a f para maiúsculas, chame-se o ToUpper() método na cadeia devolvida.

Observações

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

Aplica-se a

ToString(String, IFormatProvider)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Devolve uma representação string do valor desta instância da Guid classe, de acordo com o especificador de formato fornecido e informação de formato específica para 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

provider: IFormatProvider

(Reservado) Um objeto que fornece informação de formatação específica para cada cultura.

Devoluções

String

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

Implementações

ToString(String, IFormatProvider)

Exceções

FormatException

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

Observações

O provider parâmetro é reservado para uso futuro e não contribui para a execução deste método. Podes passar null na chamada de método.

Especificador	Formato do valor de retorno
`N`	32 dígitos: 00000000000000000000000000000000
`D`	32 dígitos separados por hífens: 00000000-0000-0000-0000-000000000000
`B`	32 dígitos separados por hífens, contidos entre colchetes: {00000000-0000-0000-0000-000000000000}
`P`	32 dígitos separados por hífens, entre parênteses: (00000000-0000-0000-0000-000000000000)
`X`	Quatro valores hexadecimais contidos entre colchetes, onde o quarto valor é um subconjunto de oito valores hexadecimais que também está incluído entre colchetes: {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 devolvida. Para os converter em maiúsculas, chama-se o String.ToUpper método na sequência devolvida.

Como o provider parâmetro é ignorado, não pode usá-lo para fornecer uma solução de formatação personalizada. Para representar um Guid valor como uma string num formato que não é suportado pelas strings de formato GUID padrão, chame o String.Format(IFormatProvider, String, Object[]) método com um provider objeto que implemente ambas as ICustomFormatter interfaces e.IFormatProvider Para mais informações, consulte a secção "Formatação Personalizada com o ICustomFormatter" no artigo Tipos de Formatação .

Aplica-se a

Comentários

Esta página foi útil?