Guid.ToString 方法

定義

命名空間:

System

組件:

System.Runtime.dll

傳回這個 Guid 結構執行個體值的字串表示。

多載

ToString(String, IFormatProvider)	根據提供的格式規範和特定文化特性格式資訊，傳回這個 Guid 類別執行個體值的字串表示。
ToString()	以登錄格式傳回這個執行個體的值的字串表示。
ToString(String)	根據提供的格式規範，傳回這個 Guid 執行個體的值的字串表示。

ToString(String, IFormatProvider)

Source:

Guid.cs

根據提供的格式規範和特定文化特性格式資訊，傳回這個 Guid 類別執行個體值的字串表示。

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

參數

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 值，請使用實 ICustomFormatter 作 和 IFormatProvider 介面的物件呼叫 String.Format(IFormatProvider, String, Object[]) 方法 provider 。 For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

ToString()

Source:

Guid.cs

以登錄格式傳回這個執行個體的值的字串表示。

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

傳回

String

這個Guid的值，已使用 "D" 格式規範來格式化，如下所示：

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

其中的 GUID 值是以一系列小寫的十六進位數字表示，按照 8、4、4、4 和 12 位數分組，以連字號分開。 傳回值的範例是 "382c74c3-721d-4f34-80e5-57657b6cbc27"。 若要將從 a 到 f 的十六進位數字轉換為大寫，請呼叫所傳回之字串的 ToUpper() 方法。

備註

這個方法提供預設 GUID 格式，足以供一般使用;不過，採用 format 參數的其他此方法版本會提供一些常見的格式變化。

ToString(String)

Source:

Guid.cs

根據提供的格式規範，傳回這個 Guid 執行個體的值的字串表示。

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

參數

format

String

單一格式規範，指出如何格式化這個 Guid 值。 format 參數可能是 "N"、"D"、"B"、"P" 或 "X"。 如果 format 是 null 或空字串 ("")，則使用 "D"。

傳回

String

這個 Guid 值，其按照指定的格式，以一系列小寫的十六進位數字來表示。

例外狀況

FormatException

format 值不是 null、空字串 ("")、"N"、"D"、"B"、"P" 或 "X"。

備註

下表顯示 參數的已接受格式規範 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 方法。