語言

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

定義

回傳根據所提供的格式指定符及文化特定格式資訊,回傳此實例值的字串表示。

 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 為空字串(「」),則使用「D」。

provider
IFormatProvider

(保留)一個提供特定文化格式資訊的物件。

傳回

此值 Guid 以指定格式中的一連串小寫十六進位數字表示。

實作

例外狀況

的 format 值不是空的,也不是空字串(“”),也不是以下單一格式的指定符之一:「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 值,請呼叫 String.Format(IFormatProvider, String, Object[]) 一個同時 provider 實 ICustomFormatter 作 和 IFormatProvider 介面的物件。 欲了解更多資訊,請參閱格式類型文章中的「Custom Formatting with ICustomFormatter」章節。

適用於