Guid.ToString 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
傳回這個 Guid 結構執行個體值的字串表示。
多載
ToString(String, IFormatProvider) |
根據提供的格式規範和特定文化特性格式資訊,傳回這個 Guid 類別執行個體值的字串表示。 |
ToString() |
以登錄格式傳回這個執行個體的值的字串表示。 |
ToString(String) |
根據提供的格式規範,傳回這個 Guid 執行個體的值的字串表示。 |
ToString(String, IFormatProvider)
- 來源:
- Guid.cs
- 來源:
- Guid.cs
- 來源:
- Guid.cs
根據提供的格式規範和特定文化特性格式資訊,傳回這個 Guid 類別執行個體值的字串表示。
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (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
(保留) 物件,提供特定文化特性格式資訊。
傳回
這個 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 值,請使用實 ICustomFormatter 作 和 IFormatProvider 介面的物件呼叫 String.Format(IFormatProvider, String, Object[]) 方法 provider
。 For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.
適用於
ToString()
- 來源:
- Guid.cs
- 來源:
- Guid.cs
- 來源:
- Guid.cs
以登錄格式傳回這個執行個體的值的字串表示。
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As 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)
- 來源:
- Guid.cs
- 來源:
- Guid.cs
- 來源:
- Guid.cs
根據提供的格式規範,傳回這個 Guid 執行個體的值的字串表示。
public:
System::String ^ ToString(System::String ^ format);
public string ToString (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"。
傳回
這個 Guid 值,其按照指定的格式,以一系列小寫的十六進位數字來表示。
例外狀況
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 方法。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應