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" を指定できます。 format が null または空の文字列 ("") の場合は、"D" が使用されます。

戻り値

String

この Guidの値。指定した形式の一連の小文字の 16 進数として表されます。

例外

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	中かっこで囲まれた 4 つの 16 進値。4 番目の値は、中かっこで囲まれた 8 つの 16 進値のサブセットです。 {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

返される文字列では、a から f までの 16 進数が小文字になります。 大文字に変換するには、返された文字列に対して 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 桁のグループで、ハイフンで区切られた一連の小文字の 16 進数として表されます。 戻り値の例として、"382c74c3-721d-4f34-80e5-57657b6cbc27" があります。 16 進数を a から 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" を指定できます。 format が null または空の文字列 ("") の場合は、"D" が使用されます。

provider

IFormatProvider

(予約済み)カルチャ固有の書式設定情報を提供するオブジェクト。

戻り値

String

この Guidの値。指定した形式の一連の小文字の 16 進数として表されます。

実装

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	中かっこで囲まれた 4 つの 16 進値。4 番目の値は、中かっこで囲まれた 8 つの 16 進値のサブセットです。 {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

返される文字列では、a から f までの 16 進数が小文字になります。 大文字に変換するには、返された文字列に対して String.ToUpper メソッドを呼び出します。

provider パラメーターは無視されるため、カスタム書式設定ソリューションを提供するために使用することはできません。 標準の GUID 書式指定文字列でサポートされていない形式の文字列として Guid 値を表すには、ICustomFormatter インターフェイスと IFormatProvider インターフェイスの両方を実装する provider オブジェクトを使用して String.Format(IFormatProvider, String, Object[]) メソッドを呼び出します。 詳細については、「書式設定の種類」 記事の「ICustomFormatter を使用したカスタム書式設定」セクションを参照してください。