Guid.IFormattable.ToString(String, IFormatProvider) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

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

 virtual System::String ^ System.IFormattable.ToString(System::String ^ format, IFormatProvider ^ provider) = IFormattable::ToString;

string IFormattable.ToString (string format, IFormatProvider provider);

abstract member System.IFormattable.ToString : string * IFormatProvider -> string
override this.System.IFormattable.ToString : string * IFormatProvider -> string

Function ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString

参数

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