Guid.ToString 方法

定义

返回 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”。 如果 formatnull 或空字符串 (""),则使用“D”。

返回

String

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

通过 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”。 如果 formatnull 或空字符串 (""),则使用“D”。

provider
IFormatProvider

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

返回

String

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

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

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

适用于