Guid.ToString 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

返回 Guid 结构的此实例值的字符串表示形式。

重载

ToString(String)	根据提供的格式说明符返回此 Guid 实例值的字符串表示形式。
ToString()	以注册表格式返回此实例值的字符串表示形式。
ToString(String, IFormatProvider)	根据提供的格式说明符和区域性特定格式信息，返回 Guid 类的此实例值的字符串表示形式。

ToString(String)

Source:

Guid.cs

根据提供的格式说明符返回此 Guid 实例值的字符串表示形式。

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

参数

format

String

一个格式说明符，指示如何设置此 Guid的值的格式。 format 参数可以是“N”、“D”、“B”、“P”或“X”。 如果使用 formatnull 或空字符串（“”），则使用“D”。

返回

String

此 Guid的值，以指定格式表示为一系列小写十六进制数字。

例外

FormatException

format 的值不是 null、空字符串（“”、“N”、“D”、“B”、“P”或“X”。

注解

下表显示了 format 参数的接受格式说明符。 “0”表示数字;连字符（“-”），大括号（“{”，“}”）和括号（“（”“，”）如下所示。

规范	返回值的格式
N	32 位数字： 00000000000000000000000000000000
D	用连字符分隔的 32 位数字： 00000000-0000-0000-0000-000000000000
B	用连字符分隔的 32 位数字，用大括号括起来： {00000000-0000-0000-0000-000000000000}
P	用连字符分隔的 32 位数字，括在括号中： (00000000-0000-0000-0000-000000000000)
X	四个十六进制值括在大括号中，其中第四个值是八个十六进制值的子集，也用大括号括起来： {0x00000000,0x0000,0x0000，{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

返回的字符串中，a 到 f 的十六进制数字是小写的。 若要将其转换为大写，请对返回的字符串调用 String.ToUpper 方法。

ToString()

Source:

Guid.cs

以注册表格式返回此实例值的字符串表示形式。

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

返回

String

此 Guid的值，使用“D”格式说明符进行格式化，如下所示：

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

其中，GUID 的值以小写十六进制数字表示为 8、4、4、4、4 和 12 位数字的一系列，并用连字符分隔。 返回值的示例为“382c74c3-721d-4f34-80e5-57657b6cbc27”。 若要将十六进制数字从 a 到 f 转换为大写，请对返回的字符串调用 ToUpper() 方法。

注解

此方法提供一种默认 GUID 格式，足以用于典型使用;但是，采用 format 参数的其他方法版本提供了一些常见的格式变体。

ToString(String, IFormatProvider)

Source:

Guid.cs

根据提供的格式说明符和区域性特定格式信息，返回 Guid 类的此实例值的字符串表示形式。

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

参数

format

String

一个格式说明符，指示如何设置此 Guid的值的格式。 format 参数可以是“N”、“D”、“B”、“P”或“X”。 如果使用 formatnull 或空字符串（“”），则使用“D”。

provider

IFormatProvider

（保留）提供区域性特定的格式设置信息的对象。

返回

String

此 Guid的值，以指定格式表示为一系列小写十六进制数字。

实现

ToString(String, IFormatProvider)

例外

FormatException

format 的值不是 null、空字符串（“”、“N”、“D”、“B”、“P”或“X”。

注解

provider 参数保留供将来使用，不会导致此方法的执行。 可以在方法调用中传递 null。

下表显示了 format 参数的接受格式说明符。 “0”表示数字;连字符（“-”），大括号（“{”，“}”）和括号（“（”“，”）如下所示。

规范	返回值的格式
N	32 位数字： 00000000000000000000000000000000
D	用连字符分隔的 32 位数字： 00000000-0000-0000-0000-000000000000
B	用连字符分隔的 32 位数字，用大括号括起来： {00000000-0000-0000-0000-000000000000}
P	用连字符分隔的 32 位数字，括在括号中： (00000000-0000-0000-0000-000000000000)
X	四个十六进制值括在大括号中，其中第四个值是八个十六进制值的子集，也用大括号括起来： {0x00000000,0x0000,0x0000，{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

返回的字符串中，a 到 f 的十六进制数字是小写的。 若要将其转换为大写，请对返回的字符串调用 String.ToUpper 方法。

由于忽略 provider 参数，因此不能使用它来提供自定义格式设置解决方案。 若要将 Guid 值表示为标准 GUID 格式字符串不支持的格式的字符串，请使用实现 ICustomFormatter 和 IFormatProvider 接口的 provider 对象调用 String.Format(IFormatProvider, String, Object[]) 方法。 有关详细信息，请参阅 格式设置类型 一文中的“使用 ICustomFormatter 自定义格式设置”部分。