Guid.ToString 方法

定義

命名空間:

System

組件:

System.Runtime.dll

傳回這個 Guid 結構實例值的字串表示。

多載

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

ToString(String)

來源:

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”。 如果 formatnull 或使用空字串 （“），則會使用 ”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 方法。

ToString()

來源:

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、4 和 12 位數的群組來表示成一系列小寫十六進位數位，並以連字元分隔。 傳回值的範例是 「382c74c3-721d-4f34-80e5-57657b6cbc27」。。 若要將十六進位數位從 轉換成 f 到大寫，請在傳回的字串上呼叫 ToUpper() 方法。

備註

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

ToString(String, IFormatProvider)

來源:

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”。 如果 formatnull 或使用空字串 （“），則會使用 ”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 介面的 provider 物件呼叫 String.Format(IFormatProvider, String, Object[]) 方法。 如需詳細資訊，請參閱 格式化類型 一文中的<使用 ICustomFormatter 自定義格式>一節。