共用方式為


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

定義

依據提供的格式指定名稱及文化特性 (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 的值,其按照指定的格式,以一系列小寫的十六進位數字來表示。

實作

例外狀況

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.

適用於