Guid.ToString 方法

  • 参考

定义

命名空间:
System
程序集:
System.Runtime.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

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

重载

ToString()

返回注册表格式的此实例值的字符串表示形式。
ToString(String)

根据所提供的格式说明符，返回此 Guid 实例值的字符串表示形式。
ToString(String, IFormatProvider)

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

ToString()

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

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 个和 12 个位为一组并由连字符分隔开。 例如，返回值可以是“382c74c3-721d-4f34-80e5-57657b6cbc27”。 若要将从 a 到 f 的十六进制数转换为大写，请对返回的字符串调用 ToUpper() 方法。

注解

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

适用于

ToString(String)

根据所提供的格式说明符，返回此 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”。

返回

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}}

通过 f 的十六进制数字在返回的字符串中小写。 若要将它们转换为大写，请在返回的字符串上调用 String.ToUpper 该方法。

适用于

ToString(String, IFormatProvider)

根据所提供的格式说明符和区域性特定的格式信息，返回 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

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

返回

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}}

通过 f 的十六进制数字在返回的字符串中小写。 若要将它们转换为大写，请在返回的字符串上调用 String.ToUpper 该方法。

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

适用于