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

定義

命名空間:

System

組件:

System.Runtime.dll

依據提供的格式指定名稱及文化特性 (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 -> 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 值，請使用實作 和 IFormatProvider 介面的物件 ICustomFormatter 呼叫 String.Format(IFormatProvider, String, Object[]) 方法 provider 。 For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.