语言

Guid.ToString 方法

定义

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

重载

名称 说明
ToString(String)

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

ToString()

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

ToString(String, IFormatProvider)

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

ToString(String)

Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

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

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

参数

format
String

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

返回

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

例外

值 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
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

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

public:
 override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

返回

使用“D”格式说明符格式化的此值 Guid,如下所示:

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
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

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

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

参数

format
String

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

provider
IFormatProvider

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

返回

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

实现

例外

值 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值,请使用String.Format(IFormatProvider, String, Object[])实现provider和ICustomFormatter接口的对象调用该方法IFormatProvider。 有关详细信息,请参阅 “格式类型 ”一文中的“使用 ICustomFormatter 自定义格式设置”部分。

适用于