Guid.ToString 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回 Guid 结构的此实例值的字符串表示形式。
重载
ToString(String, IFormatProvider) |
根据所提供的格式说明符和区域性特定的格式信息,返回 Guid 类的此实例值的字符串表示形式。 |
ToString() |
返回注册表格式的此实例值的字符串表示形式。 |
ToString(String) |
根据所提供的格式说明符,返回此 Guid 实例值的字符串表示形式。 |
ToString(String, IFormatProvider)
- 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 格式字符串不支持的格式将值表示为字符串,请使用实现 ICustomFormatter 和 IFormatProvider 接口的 对象调用 String.Format(IFormatProvider, String, Object[]) 方法provider
。 有关详细信息,请参阅格式 设置类型 一文中的“使用 ICustomFormatter 自定义格式”部分。
适用于
ToString()
- 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
返回
这 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)
- 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 对返回的字符串调用 方法。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈