Guid.IFormattable.ToString(String, IFormatProvider) メソッド

定義

名前空間:
System
アセンブリ:
mscorlib.dll, System.Runtime.dll
アセンブリ:
System.Runtime.dll

指定された書式指定子とカルチャ固有の書式情報に従って、このインスタンスの値の文字列形式を返します。

 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 の値は、指定した形式の一連の小文字の 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値を表すには、String.Format(IFormatProvider, String, Object[])インターフェイスとprovider インターフェイスの両方を実装するICustomFormatter オブジェクトを使用してIFormatProvider メソッドを呼び出します。 詳細については、「書式の種類」の記事の 「ICustomFormatter を使用したカスタム書式設定」 セクション を参照 してください。

適用対象