Guid.IFormattable.ToString(String, IFormatProvider) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
回傳根據所提供的格式指定符及文化特定格式資訊,回傳此實例值的字串表示。
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
參數
- 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」章節。