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

  • リファレンス

定義

名前空間:
System
アセンブリ:
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 の値の書式を指定する 1 文字の書式指定子。 format パラメーターには、"N"、"D"、"B"、"P"、または "X" を指定できます。 format が null または空の文字列 ("") である場合は、"D" が使用されます。

provider
IFormatProvider

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

戻り値

String

指定した書式を使用して一連の小文字の 16 進数の数字で表される、この 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 中かっこで囲まれた 4 つの 16 進値。4 番目の値は、中かっこで囲まれた 8 つの 16 進値のサブセットです。

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

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

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

適用対象