Guid.IFormattable.ToString(String, IFormatProvider) 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
依據提供的格式指定名稱及文化特性 (Culture) 專用格式資訊，傳回此執行個體之值的字串表示。
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 -> stringFunction 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
(保留) 物件，提供特定文化特性格式資訊。
這個 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 值，請使用實作 和 IFormatProvider 介面的物件 ICustomFormatter 呼叫 String.Format(IFormatProvider, String, Object[]) 方法 provider 。 For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.
| 產品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6 |
| UWP | 10.0 |