Guid.IFormattable.ToString(String, IFormatProvider) Guid.IFormattable.ToString(String, IFormatProvider) Guid.IFormattable.ToString(String, IFormatProvider) Method

定義

指定した書式指定子とカルチャ固有の書式情報に従って、このインスタンスの値を文字列形式で返します。Returns a string representation of the value of this instance, according to the provided format specifier and culture-specific format information.

 virtual System::String ^ System.IFormattable.ToString(System::String ^ format, IFormatProvider ^ provider) = IFormattable::ToString;
string IFormattable.ToString (string format, IFormatProvider provider);
Function ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString

パラメーター

format
String String String

Guid の値の書式を指定する 1 文字の書式指定子。A single format specifier that indicates how to format the value of the Guid. format パラメーターには、"N"、"D"、"B"、"P"、または "X" を指定できます。The format parameter can be "N", "D", "B", "P", or "X". format が null または空の文字列 ("") である場合は、"D" が使用されます。If format is null or an empty string (""), "D" is used.

provider
IFormatProvider IFormatProvider IFormatProvider

(予約済み) カルチャ固有の書式情報を提供するオブジェクト。(Reserved) An object that supplies culture-specific formatting information.

戻り値

指定した書式を使用して一連の小文字の 16 進数の数字で表される、この Guid の値。The value of this Guid represented as a series of lowercase hexadecimal digits in the specified format.

実装

例外

format の値は、null、空の文字列 ("")、書式指定子 "N"、"D"、"B"、"P"、"X" のいずれでもありません。The value of format is not null, an empty string (""), or one of the following single format specifiers:"N", "D", "B", "P", or "X".

注釈

provider パラメーターは将来使用するために予約されており、このメソッドの実行には関与しません。The provider parameter is reserved for future use and does not contribute to the execution of this method. メソッドの呼び出しには null を渡すことができます。You can pass null in the method call.

次の表は、format パラメーターで許容される書式指定子を示しています。The following table shows the accepted format specifiers for the format parameter. "0" は数字を表します。ハイフン ("-")、中かっこ ("{"、"}")、かっこ ("("、")") が表示されます。"0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

指定子Specifier 戻り値の形式Format of return value
N 32桁:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32ハイフンで区切られた数字:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32は、ハイフンで区切られ、中かっこで囲まれています。32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32数字はハイフンで区切られ、かっこで囲まれています。32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X 4つの16進値が中かっこで囲まれています。4番目の値は、中かっこで囲まれた8つの16進値のサブセットです。Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

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

A から f までの16進数字は、返される文字列では小文字です。The hexadecimal digits a through f are lowercase in the returned string. 大文字に変換するには、返された文字列に対して String.ToUpper メソッドを呼び出します。To convert them to uppercase, call the String.ToUpper method on the returned string.

provider パラメーターは無視されるため、カスタム書式指定ソリューションを提供するために使用することはできません。Because the provider parameter is ignored, you cannot use it to provide a custom formatting solution. Guid の値を、標準の GUID 書式指定文字列でサポートされていない形式の文字列として表すには、IFormatProviderprovider の両方のインターフェイスを実装する ICustomFormatter のオブジェクトを使用して、String.Format(IFormatProvider, String, Object[]) のメソッドを呼び出します。To represent a Guid value as a string in a format that isn't supported by the standard GUID format strings, call the String.Format(IFormatProvider, String, Object[]) method with a provider object that implements both the ICustomFormatter and IFormatProvider interfaces. 詳細については、「型の書式設定」の「 ICustomFormatter を使用したカスタム書式設定」セクションを参照してください。For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

適用対象